Add SQLAlchemy, Flask-Migrate, and Flask-Admin to Flask init scripts

New scripts:
- flask/31-environ.sh: python-dotenv + example.env
- flask/32-sqlalchemy.sh: Flask-SQLAlchemy + psycopg
- flask/33-alembic.sh: Flask-Migrate (Alembic wrapper)
- flask/34-admin.sh: Flask-Admin

Updated:
- flask/30-flask.sh: app.py now loads config from .env, sets up SQLAlchemy
- flask/everything.sh: sources all new scripts
- flask/test.sh: copies example.env before running pytest
- .github/workflows/test.yaml: passes DATABASE_URL for Flask tests
- flask/example/: regenerated
- AGENTS.md: clarify rule to prevent plan-only sessions

Co-authored-by: SupraSummus <15822143+SupraSummus@users.noreply.github.com>

Author: Copilot

.github/workflows/test.yaml

@@ -43,6 +43,8 @@ jobs:
           DATABASE_URL: postgresql://postgres:postgrespass@localhost:5432/testdb
       - run: ./test.sh
         working-directory: flask
+        env:
+          DATABASE_URL: postgresql://postgres:postgrespass@localhost:5432/testdb
       - run: ./fastapi/test.sh
         env:
           DATABASE_URL: postgresql+asyncpg://postgres:postgrespass@localhost:5432/postgres

AGENTS.md

@@ -3,3 +3,4 @@
 ## Rules
 
 - We aim to generate a bare usable minimum. Do not include example models, placeholder data, or unnecessary boilerplate that the user would have to delete.
+- When asked to add a feature, implement actual code changes. Planning without implementation is not acceptable.

flask/30-flask.sh

@@ -5,19 +5,24 @@ poetry add 'flask==*'
 
 # Create the main application file
 cat > "app.py" <<EOF
+import os
+
+from dotenv import load_dotenv
 from flask import Flask
+from flask_sqlalchemy import SQLAlchemy
 
+load_dotenv()
 
 app = Flask(__name__)
+app.config['SECRET_KEY'] = os.environ.get('SECRET_KEY', 'changeme')
+app.config['SQLALCHEMY_DATABASE_URI'] = os.environ['DATABASE_URL']
+
+db = SQLAlchemy(app)
 
 
 @app.route('/')
 def index():
     return 'Hello, World!'
-
-
-if __name__ == '__main__':
-    app.run()
 EOF
 
 # Create test file in root

flask/31-environ.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# Install python-dotenv for environment configuration
+poetry add 'python-dotenv==*'
+
+# Create example.env file
+cat <<EOF > example.env
+DEBUG=True
+DATABASE_URL=postgresql://localhost/$POETRY_PROJECT_NAME
+SECRET_KEY=your_secret_key_here
+EOF
+
+# Add .env to .gitignore
+echo ".env" >> .gitignore
+
+# Add to README
+cat <<EOF >> "README.md"
+
+## Environment Variables
+
+Configure quick-start env vars:
+
+    cp example.env .env
+EOF
+
+git add --all
+git commit -m "Install python-dotenv and configure environment"

flask/32-sqlalchemy.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+# Install Flask-SQLAlchemy and psycopg
+poetry add 'flask-sqlalchemy==*'
+poetry add 'psycopg==*'
+
+# Create models module
+cat > "models.py" <<EOF
+from app import db  # noqa: F401
+EOF
+
+poetry run isort .
+git add --all
+git commit -m "Install and configure Flask-SQLAlchemy"

flask/33-alembic.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+
+# Install Flask-Migrate (Alembic wrapper for Flask-SQLAlchemy)
+poetry add 'flask-migrate==*'
+
+# Add Flask-Migrate initialization to app.py
+sed -i '/^from flask_sqlalchemy import SQLAlchemy/a from flask_migrate import Migrate' app.py
+sed -i '/^db = SQLAlchemy(app)/a migrate = Migrate(app, db)' app.py
+
+# Add to README
+cat <<EOF >> "README.md"
+
+## Database Migrations
+
+Create a new migration:
+
+    poetry run flask db migrate -m "Description"
+
+Apply migrations:
+
+    poetry run flask db upgrade
+EOF
+
+poetry run isort .
+git add --all
+git commit -m "Install and configure Flask-Migrate for database migrations"

flask/34-admin.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+# Install Flask-Admin
+poetry add 'flask-admin==*'
+
+# Add Flask-Admin initialization to app.py
+sed -i '/^from flask_migrate import Migrate/a from flask_admin import Admin' app.py
+sed -i '/^migrate = Migrate(app, db)/a admin = Admin(app)' app.py
+
+poetry run isort .
+git add --all
+git commit -m "Install and configure Flask-Admin"

flask/everything.sh

@@ -11,4 +11,8 @@ source "$script_dir/../20-poetry.sh"
 source "$script_dir/../21-flake.sh"
 source "$script_dir/../22-isort.sh"
 source "$script_dir/../23-pytest.sh"
+source "$script_dir/31-environ.sh"
 source "$script_dir/30-flask.sh"
+source "$script_dir/32-sqlalchemy.sh"
+source "$script_dir/33-alembic.sh"
+source "$script_dir/34-admin.sh"

flask/example/.gitignore

@@ -1 +1,2 @@
 __pycache__/
+.env

flask/example/README.md

@@ -9,3 +9,19 @@ This project uses Poetry for dependency management. To install the dependencies,
 To activate the virtual environment, run:
 
     poetry shell
+
+## Environment Variables
+
+Configure quick-start env vars:
+
+    cp example.env .env
+
+## Database Migrations
+
+Create a new migration:
+
+    poetry run flask db migrate -m "Description"
+
+Apply migrations:
+
+    poetry run flask db upgrade