lambda-forge-cli-aws 1.0.0__tar.gz

lambda_forge_cli_aws-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,91 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint (ruff)
+        run: ruff check .
+
+      - name: Format check (ruff)
+        run: ruff format --check .
+
+      - name: Type check (mypy)
+        run: mypy src/
+
+  test:
+    name: Tests
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest --cov-report=xml
+        env:
+          AWS_DEFAULT_REGION: us-east-1
+          AWS_ACCESS_KEY_ID: testing
+          AWS_SECRET_ACCESS_KEY: testing
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: always()
+        with:
+          file: coverage.xml
+          fail_ci_if_error: false
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify package
+        run: |
+          pip install dist/*.whl
+          lambdaforge version

lambda_forge_cli_aws-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,139 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  test:
+    name: Verificar Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Instalar dependencias
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check .
+
+      - name: Tests
+        run: pytest --cov=src/lambdaforge
+        env:
+          AWS_DEFAULT_REGION: us-east-1
+          AWS_ACCESS_KEY_ID: testing
+          AWS_SECRET_ACCESS_KEY: testing
+
+  build:
+    name: Build Package
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Instalar herramientas de build
+        run: pip install build
+
+      - name: Build sdist y wheel
+        run: python -m build
+
+      - name: Verificar paquete
+        run: |
+          pip install dist/*.whl
+          lambdaforge version
+          lambdaforge templates
+
+      - name: Guardar artefactos
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    name: Publicar en Test PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Publicar en Test PyPI
+        run: |
+          pip install twine
+          twine upload --repository testpypi dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+        continue-on-error: true
+
+  publish-pypi:
+    name: Publicar en PyPI
+    needs: [build, publish-testpypi]
+    runs-on: ubuntu-latest
+    environment: release
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Publicar en PyPI
+        run: |
+          pip install twine
+          twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+
+  github-release:
+    name: Crear GitHub Release
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Crear Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*
+          body: |
+            ## Instalación
+
+            ```bash
+            pip install lambdaforge==${{ github.ref_name }}
+            ```
+
+            ## Cambios
+
+            Ver [CHANGELOG.md](https://github.com/blaylopez/lambdaforge/blob/main/CHANGELOG.md) para detalles completos.

lambda_forge_cli_aws-1.0.0/.gitignore

@@ -0,0 +1,73 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+
+# Type checking
+.mypy_cache/
+.ruff_cache/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# CDK
+cdk.out/
+cdk.context.json
+
+# Lambda
+*.zip
+
+# Environment / Secrets
+.env
+.env.local
+.env.*.local
+*.pem
+*.key
+secrets.yml
+
+# Distribution
+dist/
+*.tar.gz
+*.whl
+
+
+# Demo projects (generated, not tracked)
+demos/

lambda_forge_cli_aws-1.0.0/.kiro/hooks/lint-on-save.kiro.hook

@@ -0,0 +1,17 @@
+{
+  "enabled": true,
+  "name": "Lint on Save",
+  "description": "Runs ruff check on saved Python files to catch lint issues immediately",
+  "version": "1",
+  "when": {
+    "type": "fileEdited",
+    "patterns": [
+      "src/**/*.py",
+      "tests/**/*.py"
+    ]
+  },
+  "then": {
+    "type": "runCommand",
+    "command": "python -m ruff check --fix {file}"
+  }
+}

lambda_forge_cli_aws-1.0.0/.kiro/hooks/run-tests-after-task.kiro.hook

@@ -0,0 +1,13 @@
+{
+  "enabled": true,
+  "name": "Run Tests After Task",
+  "description": "Runs the test suite after agent completes a task to catch regressions",
+  "version": "1",
+  "when": {
+    "type": "postTaskExecution"
+  },
+  "then": {
+    "type": "runCommand",
+    "command": "python -m pytest tests/ -x -q --tb=short 2>&1 | head -30"
+  }
+}

lambda_forge_cli_aws-1.0.0/.kiro/hooks/security-check-infra.kiro.hook

@@ -0,0 +1,16 @@
+{
+  "enabled": true,
+  "name": "Security Gate for Infra",
+  "description": "Reminds the agent to verify security standards before writing to infrastructure, deploy, or bedrock files",
+  "version": "1",
+  "when": {
+    "type": "preToolUse",
+    "toolTypes": [
+      "write"
+    ]
+  },
+  "then": {
+    "type": "askAgent",
+    "prompt": "Before writing to this infrastructure or security-sensitive file, verify: 1) No hardcoded credentials or secrets, 2) No shell=True in subprocess calls, 3) No wildcard (*) resource ARNs in IAM policies, 4) Subprocess commands use list format. If all checks pass, proceed with the write."
+  }
+}

lambda_forge_cli_aws-1.0.0/.kiro/hooks/template-standards-check.kiro.hook

@@ -0,0 +1,16 @@
+{
+  "enabled": true,
+  "name": "Template Standards Check",
+  "description": "When a new template file is created, reminds to verify it follows the template steering standards",
+  "version": "1",
+  "when": {
+    "type": "fileCreated",
+    "patterns": [
+      "templates/**/*"
+    ]
+  },
+  "then": {
+    "type": "askAgent",
+    "prompt": "A new template file was created. Verify it follows the template steering standards: 1) cookiecutter.json has all required variables (project_name, project_slug, module_name, description, author_name, author_email, runtime, aws_region, memory_mb, timeout_seconds), 2) Handler uses aws-lambda-powertools Logger and Tracer, 3) CDK stack uses ARM64 + X-Ray + log retention + CloudWatch dashboard + Well-Architected tags, 4) .gitignore excludes secrets. Fix any violations."
+  }
+}

lambda_forge_cli_aws-1.0.0/.kiro/hooks/validate-cookiecutter-vars.kiro.hook

@@ -0,0 +1,16 @@
+{
+  "enabled": true,
+  "name": "Validate Cookiecutter Vars",
+  "description": "Validates that cookiecutter.json has all required variables before committing template changes",
+  "version": "1",
+  "when": {
+    "type": "fileEdited",
+    "patterns": [
+      "templates/**/cookiecutter.json"
+    ]
+  },
+  "then": {
+    "type": "askAgent",
+    "prompt": "The cookiecutter.json was modified. Verify all required variables are present: project_name, project_slug, module_name, description, author_name, author_email, runtime, aws_region, memory_mb, timeout_seconds. Also verify that any variable referenced in template files (search for {{ cookiecutter. patterns) exists in this JSON. Report any missing variables."
+  }
+}

lambda_forge_cli_aws-1.0.0/.kiro/specs/00-overview.md

@@ -0,0 +1,77 @@
+# LambdaForge — Overview Specification
+
+## Project Identity
+
+- **Name:** LambdaForge
+- **Tagline:** *De cero a Lambda production-ready en 60 segundos, con Kiro specs incluidas.*
+- **Category:** HACKATHONKIRO — Productividad para developers
+- **Version:** 1.0.0
+- **License:** Apache 2.0
+
+## Mission Statement
+
+Eliminar las 2-3 horas de boilerplate que toma crear una AWS Lambda "bien hecha" (estructura, tests, IaC, observabilidad, docs). En 60 segundos, un developer tiene una Lambda production-ready con todos los ingredientes que un senior esperaría.
+
+## The Problem We Solve
+
+1. **Boilerplate infinito.** Crear una Lambda "correcta" requiere: handler, tests, IaC, IAM, CloudWatch dashboard, observability, README, .kiro/specs/. Repetitivo y aburrido.
+
+2. **Inconsistencia entre Lambdas.** Cada developer estructura diferente. No hay estándar de equipo.
+
+3. **Fricción con IaC.** CDK es poderoso pero verboso. Los juniors lo evitan.
+
+4. **Well-Architected cuesta.** Lambdas sin observability, sin DLQ, sin X-Ray, sin tags. Las auditorías duelen.
+
+5. **No hay Kiro specs desde el inicio.** Specs se escriben después (nunca). SpecForge los genera retroactivamente, pero LambdaForge los incluye desde el día 0.
+
+## The Solution
+
+Una CLI que genera Lambdas production-ready con un comando:
+
+```bash
+lambdaforge new payment-processor \
+  --runtime python3.12 \
+  --trigger api-gateway \
+  --database dynamodb \
+  --auth cognito \
+  --observability xray
+```
+
+Output:
+- Estructura de proyecto Python completa
+- Tests con `pytest` + `moto` (mocking AWS)
+- AWS CDK stack (JavaScript) con Lambda + IAM + API GW
+- CloudWatch dashboard pre-configurado
+- GitHub Actions workflow (CI/CD)
+- **`.kiro/specs/`** generado proactivamente
+- README profesional
+- Dockerfile para testing local
+- Logging estructurado (JSON)
+- Tracing con X-Ray
+- Cost estimation en el README
+
+## Success Metrics
+
+| Métrica | Target | Medición |
+|---|---|---|
+| Tiempo de generación de Lambda | < 60s | Benchmark suite |
+| Tiempo de "a deployed" con un click | < 5 min | `lambdaforge deploy` |
+| Tests generados con coverage | > 80% | Auto-verificación |
+| Templates disponibles | 25+ casos | Catálogo |
+| Líneas de código boilerplate evitadas | > 500 por Lambda | Comparación |
+| Developers adoptan Well-Architected | 100% (forzado) | Tag check |
+| .kiro/specs/ funcionales | 100% (auto-generados) | Kiro load test |
+
+## Stakeholders
+
+- **Primary:** Developers creando Lambdas nuevas
+- **Secondary:** Equipos que estandarizan su serverless
+- **Tertiary:** Educadores enseñando AWS
+- **Quaternary:** Open source maintainers publicando Lambdas
+
+## Non-Goals (v1.0)
+
+- ❌ No es un framework serverless completo (vs. SAM, SST)
+- ❌ No soporta Step Functions, EventBridge Schemas complejos
+- ❌ No es un debugger de Lambdas (usa SAM local o AWS Toolkit)
+- ❌ No genera Lambdas en otros lenguajes primero (Python primero, luego TS)