aiox-core 5.0.3 → 5.0.5

package/.aiox-core/product/templates/tmpl-seed-data.sql

@@ -1,140 +1,140 @@
--- Seed Data Template
--- Purpose: Idempotent seed data for development and testing
--- Created: :created_date
--- Author: :author
---
--- IMPORTANT: All seed operations should be idempotent (safe to run multiple times)
-
--- =============================================================================
--- SEED CONFIGURATION
--- =============================================================================
-
--- Disable triggers during seeding (optional, speeds up bulk insert)
--- SET session_replication_role = replica;
-
-BEGIN;
-
--- =============================================================================
--- SEED: REFERENCE DATA (Lookup tables, static data)
--- =============================================================================
-
--- Example: Status types
-INSERT INTO status_types (id, name, description, sort_order)
-VALUES
-    ('11111111-1111-1111-1111-111111111001', 'draft', 'Initial draft state', 1),
-    ('11111111-1111-1111-1111-111111111002', 'pending', 'Awaiting action', 2),
-    ('11111111-1111-1111-1111-111111111003', 'active', 'Currently active', 3),
-    ('11111111-1111-1111-1111-111111111004', 'completed', 'Work completed', 4),
-    ('11111111-1111-1111-1111-111111111005', 'archived', 'No longer active', 5)
-ON CONFLICT (id) DO UPDATE SET
-    name = EXCLUDED.name,
-    description = EXCLUDED.description,
-    sort_order = EXCLUDED.sort_order;
-
--- Example: Categories
-INSERT INTO categories (id, name, slug, parent_id)
-VALUES
-    ('22222222-2222-2222-2222-222222222001', 'General', 'general', NULL),
-    ('22222222-2222-2222-2222-222222222002', 'Development', 'development', NULL),
-    ('22222222-2222-2222-2222-222222222003', 'Frontend', 'frontend', '22222222-2222-2222-2222-222222222002'),
-    ('22222222-2222-2222-2222-222222222004', 'Backend', 'backend', '22222222-2222-2222-2222-222222222002')
-ON CONFLICT (id) DO UPDATE SET
-    name = EXCLUDED.name,
-    slug = EXCLUDED.slug,
-    parent_id = EXCLUDED.parent_id;
-
--- =============================================================================
--- SEED: ROLES AND PERMISSIONS
--- =============================================================================
-
-INSERT INTO roles (id, name, description, permissions)
-VALUES
-    ('33333333-3333-3333-3333-333333333001', 'admin', 'Full system access', '["*"]'::JSONB),
-    ('33333333-3333-3333-3333-333333333002', 'editor', 'Can edit content', '["read", "write", "update"]'::JSONB),
-    ('33333333-3333-3333-3333-333333333003', 'viewer', 'Read-only access', '["read"]'::JSONB)
-ON CONFLICT (id) DO UPDATE SET
-    description = EXCLUDED.description,
-    permissions = EXCLUDED.permissions;
-
--- =============================================================================
--- SEED: TEST USERS (Development only!)
--- =============================================================================
-
--- NOTE: Only run in development environment
--- These are fake users for testing - DO NOT use in production
-
--- Check environment before inserting test data
-DO $$
-BEGIN
-    -- Only seed test users if this appears to be a dev environment
-    IF current_database() LIKE '%dev%' OR current_database() LIKE '%test%' THEN
-        -- Test Admin User
-        INSERT INTO auth.users (
-            id,
-            email,
-            encrypted_password,
-            email_confirmed_at,
-            raw_user_meta_data
-        ) VALUES (
-            '00000000-0000-0000-0000-000000000001',
-            'admin@test.local',
-            crypt('testpassword123', gen_salt('bf')),
-            NOW(),
-            '{"full_name": "Test Admin"}'::JSONB
-        ) ON CONFLICT (id) DO NOTHING;
-
-        -- Test Regular User
-        INSERT INTO auth.users (
-            id,
-            email,
-            encrypted_password,
-            email_confirmed_at,
-            raw_user_meta_data
-        ) VALUES (
-            '00000000-0000-0000-0000-000000000002',
-            'user@test.local',
-            crypt('testpassword123', gen_salt('bf')),
-            NOW(),
-            '{"full_name": "Test User"}'::JSONB
-        ) ON CONFLICT (id) DO NOTHING;
-
-        RAISE NOTICE 'Test users seeded successfully';
-    ELSE
-        RAISE NOTICE 'Skipping test user seeding - not a dev/test environment';
-    END IF;
-END $$;
-
--- =============================================================================
--- SEED: SAMPLE DATA (Development only!)
--- =============================================================================
-
--- Example: Sample projects for testing
-INSERT INTO :table_name (id, name, description, user_id, status, created_at)
-VALUES
-    ('44444444-4444-4444-4444-444444444001', 'Sample Project 1', 'First sample project for testing', '00000000-0000-0000-0000-000000000001', 'active', NOW()),
-    ('44444444-4444-4444-4444-444444444002', 'Sample Project 2', 'Second sample project for testing', '00000000-0000-0000-0000-000000000002', 'draft', NOW())
-ON CONFLICT (id) DO UPDATE SET
-    name = EXCLUDED.name,
-    description = EXCLUDED.description,
-    updated_at = NOW();
-
-COMMIT;
-
--- =============================================================================
--- RE-ENABLE TRIGGERS
--- =============================================================================
-
--- SET session_replication_role = DEFAULT;
-
--- =============================================================================
--- VERIFICATION
--- =============================================================================
-
-SELECT
-    'status_types' as table_name,
-    COUNT(*) as row_count
-FROM status_types
-UNION ALL
-SELECT 'categories', COUNT(*) FROM categories
-UNION ALL
-SELECT 'roles', COUNT(*) FROM roles;
+-- Seed Data Template
+-- Purpose: Idempotent seed data for development and testing
+-- Created: :created_date
+-- Author: :author
+--
+-- IMPORTANT: All seed operations should be idempotent (safe to run multiple times)
+
+-- =============================================================================
+-- SEED CONFIGURATION
+-- =============================================================================
+
+-- Disable triggers during seeding (optional, speeds up bulk insert)
+-- SET session_replication_role = replica;
+
+BEGIN;
+
+-- =============================================================================
+-- SEED: REFERENCE DATA (Lookup tables, static data)
+-- =============================================================================
+
+-- Example: Status types
+INSERT INTO status_types (id, name, description, sort_order)
+VALUES
+    ('11111111-1111-1111-1111-111111111001', 'draft', 'Initial draft state', 1),
+    ('11111111-1111-1111-1111-111111111002', 'pending', 'Awaiting action', 2),
+    ('11111111-1111-1111-1111-111111111003', 'active', 'Currently active', 3),
+    ('11111111-1111-1111-1111-111111111004', 'completed', 'Work completed', 4),
+    ('11111111-1111-1111-1111-111111111005', 'archived', 'No longer active', 5)
+ON CONFLICT (id) DO UPDATE SET
+    name = EXCLUDED.name,
+    description = EXCLUDED.description,
+    sort_order = EXCLUDED.sort_order;
+
+-- Example: Categories
+INSERT INTO categories (id, name, slug, parent_id)
+VALUES
+    ('22222222-2222-2222-2222-222222222001', 'General', 'general', NULL),
+    ('22222222-2222-2222-2222-222222222002', 'Development', 'development', NULL),
+    ('22222222-2222-2222-2222-222222222003', 'Frontend', 'frontend', '22222222-2222-2222-2222-222222222002'),
+    ('22222222-2222-2222-2222-222222222004', 'Backend', 'backend', '22222222-2222-2222-2222-222222222002')
+ON CONFLICT (id) DO UPDATE SET
+    name = EXCLUDED.name,
+    slug = EXCLUDED.slug,
+    parent_id = EXCLUDED.parent_id;
+
+-- =============================================================================
+-- SEED: ROLES AND PERMISSIONS
+-- =============================================================================
+
+INSERT INTO roles (id, name, description, permissions)
+VALUES
+    ('33333333-3333-3333-3333-333333333001', 'admin', 'Full system access', '["*"]'::JSONB),
+    ('33333333-3333-3333-3333-333333333002', 'editor', 'Can edit content', '["read", "write", "update"]'::JSONB),
+    ('33333333-3333-3333-3333-333333333003', 'viewer', 'Read-only access', '["read"]'::JSONB)
+ON CONFLICT (id) DO UPDATE SET
+    description = EXCLUDED.description,
+    permissions = EXCLUDED.permissions;
+
+-- =============================================================================
+-- SEED: TEST USERS (Development only!)
+-- =============================================================================
+
+-- NOTE: Only run in development environment
+-- These are fake users for testing - DO NOT use in production
+
+-- Check environment before inserting test data
+DO $$
+BEGIN
+    -- Only seed test users if this appears to be a dev environment
+    IF current_database() LIKE '%dev%' OR current_database() LIKE '%test%' THEN
+        -- Test Admin User
+        INSERT INTO auth.users (
+            id,
+            email,
+            encrypted_password,
+            email_confirmed_at,
+            raw_user_meta_data
+        ) VALUES (
+            '00000000-0000-0000-0000-000000000001',
+            'admin@test.local',
+            crypt('testpassword123', gen_salt('bf')),
+            NOW(),
+            '{"full_name": "Test Admin"}'::JSONB
+        ) ON CONFLICT (id) DO NOTHING;
+
+        -- Test Regular User
+        INSERT INTO auth.users (
+            id,
+            email,
+            encrypted_password,
+            email_confirmed_at,
+            raw_user_meta_data
+        ) VALUES (
+            '00000000-0000-0000-0000-000000000002',
+            'user@test.local',
+            crypt('testpassword123', gen_salt('bf')),
+            NOW(),
+            '{"full_name": "Test User"}'::JSONB
+        ) ON CONFLICT (id) DO NOTHING;
+
+        RAISE NOTICE 'Test users seeded successfully';
+    ELSE
+        RAISE NOTICE 'Skipping test user seeding - not a dev/test environment';
+    END IF;
+END $$;
+
+-- =============================================================================
+-- SEED: SAMPLE DATA (Development only!)
+-- =============================================================================
+
+-- Example: Sample projects for testing
+INSERT INTO :table_name (id, name, description, user_id, status, created_at)
+VALUES
+    ('44444444-4444-4444-4444-444444444001', 'Sample Project 1', 'First sample project for testing', '00000000-0000-0000-0000-000000000001', 'active', NOW()),
+    ('44444444-4444-4444-4444-444444444002', 'Sample Project 2', 'Second sample project for testing', '00000000-0000-0000-0000-000000000002', 'draft', NOW())
+ON CONFLICT (id) DO UPDATE SET
+    name = EXCLUDED.name,
+    description = EXCLUDED.description,
+    updated_at = NOW();
+
+COMMIT;
+
+-- =============================================================================
+-- RE-ENABLE TRIGGERS
+-- =============================================================================
+
+-- SET session_replication_role = DEFAULT;
+
+-- =============================================================================
+-- VERIFICATION
+-- =============================================================================
+
+SELECT
+    'status_types' as table_name,
+    COUNT(*) as row_count
+FROM status_types
+UNION ALL
+SELECT 'categories', COUNT(*) FROM categories
+UNION ALL
+SELECT 'roles', COUNT(*) FROM roles;

package/.aiox-core/product/templates/tmpl-smoke-test.sql

@@ -1,16 +1,16 @@
--- Basic post-migration checks (fill placeholders)
-SET client_min_messages = warning;
-
--- Count tables/policies/functions expected
-SELECT COUNT(*) AS tables FROM information_schema.tables WHERE table_schema='public';
-SELECT COUNT(*) AS policies FROM pg_policies WHERE schemaname='public';
-SELECT proname FROM pg_proc WHERE pronamespace = 'public'::regnamespace
-  AND proname IN ('current_mind_id','provision_user_profile','set_fragment_mind_id');
-
--- Sanity queries (examples)
--- SELECT * FROM categories LIMIT 5;
--- SELECT * FROM minds LIMIT 5;
-
--- RLS sanity (should not error even if it returns 0)
--- SET LOCAL request.jwt.claims = '{"sub":"<user-uuid>","role":"authenticated"}';
--- SELECT 1 FROM fragments WHERE false;
+-- Basic post-migration checks (fill placeholders)
+SET client_min_messages = warning;
+
+-- Count tables/policies/functions expected
+SELECT COUNT(*) AS tables FROM information_schema.tables WHERE table_schema='public';
+SELECT COUNT(*) AS policies FROM pg_policies WHERE schemaname='public';
+SELECT proname FROM pg_proc WHERE pronamespace = 'public'::regnamespace
+  AND proname IN ('current_mind_id','provision_user_profile','set_fragment_mind_id');
+
+-- Sanity queries (examples)
+-- SELECT * FROM categories LIMIT 5;
+-- SELECT * FROM minds LIMIT 5;
+
+-- RLS sanity (should not error even if it returns 0)
+-- SET LOCAL request.jwt.claims = '{"sub":"<user-uuid>","role":"authenticated"}';
+-- SELECT 1 FROM fragments WHERE false;

package/.aiox-core/product/templates/tmpl-staging-copy-merge.sql

@@ -1,139 +1,139 @@
--- Staging Copy Merge Template
--- Purpose: Safely load external data through staging table and merge to target
--- Created: :created_date
--- Author: :author
---
--- This pattern prevents data corruption by validating in staging before merge
-
--- =============================================================================
--- STEP 1: CREATE STAGING TABLE (temporary)
--- =============================================================================
-
--- Create staging table mirroring target structure
-CREATE TEMP TABLE IF NOT EXISTS :staging_table (
-    -- Match target table columns
-    id UUID,
-    :column1 :type1,
-    :column2 :type2,
-    -- Metadata for import tracking
-    _row_number INTEGER,
-    _import_status TEXT DEFAULT 'pending',
-    _import_error TEXT
-);
-
--- =============================================================================
--- STEP 2: COPY DATA TO STAGING
--- =============================================================================
-
--- Option A: From CSV file
--- COPY :staging_table (id, :column1, :column2)
--- FROM '/path/to/file.csv'
--- WITH (FORMAT csv, HEADER true);
-
--- Option B: From STDIN (programmatic)
--- COPY :staging_table (id, :column1, :column2) FROM STDIN;
-
--- Option C: Insert from another query
--- INSERT INTO :staging_table (id, :column1, :column2)
--- SELECT id, col1, col2 FROM external_source;
-
--- =============================================================================
--- STEP 3: VALIDATE STAGING DATA
--- =============================================================================
-
--- Mark rows with validation errors
-UPDATE :staging_table
-SET
-    _import_status = 'error',
-    _import_error = 'Missing required field'
-WHERE :column1 IS NULL;
-
--- Check for duplicates
-UPDATE :staging_table s
-SET
-    _import_status = 'duplicate',
-    _import_error = 'Duplicate ID found'
-WHERE EXISTS (
-    SELECT 1 FROM :staging_table s2
-    WHERE s2.id = s.id
-    AND s2._row_number < s._row_number
-);
-
--- Check for existing records (will update instead of insert)
-UPDATE :staging_table s
-SET _import_status = 'update'
-WHERE EXISTS (
-    SELECT 1 FROM :target_table t
-    WHERE t.id = s.id
-)
-AND s._import_status = 'pending';
-
--- Mark remaining as new inserts
-UPDATE :staging_table
-SET _import_status = 'insert'
-WHERE _import_status = 'pending';
-
--- =============================================================================
--- STEP 4: REPORT VALIDATION RESULTS
--- =============================================================================
-
--- Get summary of staging data
-SELECT
-    _import_status,
-    COUNT(*) as count,
-    STRING_AGG(DISTINCT _import_error, ', ') as errors
-FROM :staging_table
-GROUP BY _import_status
-ORDER BY _import_status;
-
--- =============================================================================
--- STEP 5: MERGE TO TARGET (UPSERT)
--- =============================================================================
-
-BEGIN;
-
--- Insert new records
-INSERT INTO :target_table (id, :column1, :column2, created_at)
-SELECT id, :column1, :column2, NOW()
-FROM :staging_table
-WHERE _import_status = 'insert';
-
--- Update existing records
-UPDATE :target_table t
-SET
-    :column1 = s.:column1,
-    :column2 = s.:column2,
-    updated_at = NOW()
-FROM :staging_table s
-WHERE t.id = s.id
-AND s._import_status = 'update';
-
-COMMIT;
-
--- =============================================================================
--- STEP 6: VERIFY AND CLEANUP
--- =============================================================================
-
--- Verify merge results
-SELECT
-    'inserted' as operation,
-    COUNT(*) as count
-FROM :staging_table WHERE _import_status = 'insert'
-UNION ALL
-SELECT
-    'updated' as operation,
-    COUNT(*) as count
-FROM :staging_table WHERE _import_status = 'update'
-UNION ALL
-SELECT
-    'errors' as operation,
-    COUNT(*) as count
-FROM :staging_table WHERE _import_status = 'error';
-
--- Get error details for review
-SELECT id, :column1, _import_error
-FROM :staging_table
-WHERE _import_status = 'error';
-
--- Drop staging table (automatic for TEMP, but explicit is clearer)
-DROP TABLE IF EXISTS :staging_table;
+-- Staging Copy Merge Template
+-- Purpose: Safely load external data through staging table and merge to target
+-- Created: :created_date
+-- Author: :author
+--
+-- This pattern prevents data corruption by validating in staging before merge
+
+-- =============================================================================
+-- STEP 1: CREATE STAGING TABLE (temporary)
+-- =============================================================================
+
+-- Create staging table mirroring target structure
+CREATE TEMP TABLE IF NOT EXISTS :staging_table (
+    -- Match target table columns
+    id UUID,
+    :column1 :type1,
+    :column2 :type2,
+    -- Metadata for import tracking
+    _row_number INTEGER,
+    _import_status TEXT DEFAULT 'pending',
+    _import_error TEXT
+);
+
+-- =============================================================================
+-- STEP 2: COPY DATA TO STAGING
+-- =============================================================================
+
+-- Option A: From CSV file
+-- COPY :staging_table (id, :column1, :column2)
+-- FROM '/path/to/file.csv'
+-- WITH (FORMAT csv, HEADER true);
+
+-- Option B: From STDIN (programmatic)
+-- COPY :staging_table (id, :column1, :column2) FROM STDIN;
+
+-- Option C: Insert from another query
+-- INSERT INTO :staging_table (id, :column1, :column2)
+-- SELECT id, col1, col2 FROM external_source;
+
+-- =============================================================================
+-- STEP 3: VALIDATE STAGING DATA
+-- =============================================================================
+
+-- Mark rows with validation errors
+UPDATE :staging_table
+SET
+    _import_status = 'error',
+    _import_error = 'Missing required field'
+WHERE :column1 IS NULL;
+
+-- Check for duplicates
+UPDATE :staging_table s
+SET
+    _import_status = 'duplicate',
+    _import_error = 'Duplicate ID found'
+WHERE EXISTS (
+    SELECT 1 FROM :staging_table s2
+    WHERE s2.id = s.id
+    AND s2._row_number < s._row_number
+);
+
+-- Check for existing records (will update instead of insert)
+UPDATE :staging_table s
+SET _import_status = 'update'
+WHERE EXISTS (
+    SELECT 1 FROM :target_table t
+    WHERE t.id = s.id
+)
+AND s._import_status = 'pending';
+
+-- Mark remaining as new inserts
+UPDATE :staging_table
+SET _import_status = 'insert'
+WHERE _import_status = 'pending';
+
+-- =============================================================================
+-- STEP 4: REPORT VALIDATION RESULTS
+-- =============================================================================
+
+-- Get summary of staging data
+SELECT
+    _import_status,
+    COUNT(*) as count,
+    STRING_AGG(DISTINCT _import_error, ', ') as errors
+FROM :staging_table
+GROUP BY _import_status
+ORDER BY _import_status;
+
+-- =============================================================================
+-- STEP 5: MERGE TO TARGET (UPSERT)
+-- =============================================================================
+
+BEGIN;
+
+-- Insert new records
+INSERT INTO :target_table (id, :column1, :column2, created_at)
+SELECT id, :column1, :column2, NOW()
+FROM :staging_table
+WHERE _import_status = 'insert';
+
+-- Update existing records
+UPDATE :target_table t
+SET
+    :column1 = s.:column1,
+    :column2 = s.:column2,
+    updated_at = NOW()
+FROM :staging_table s
+WHERE t.id = s.id
+AND s._import_status = 'update';
+
+COMMIT;
+
+-- =============================================================================
+-- STEP 6: VERIFY AND CLEANUP
+-- =============================================================================
+
+-- Verify merge results
+SELECT
+    'inserted' as operation,
+    COUNT(*) as count
+FROM :staging_table WHERE _import_status = 'insert'
+UNION ALL
+SELECT
+    'updated' as operation,
+    COUNT(*) as count
+FROM :staging_table WHERE _import_status = 'update'
+UNION ALL
+SELECT
+    'errors' as operation,
+    COUNT(*) as count
+FROM :staging_table WHERE _import_status = 'error';
+
+-- Get error details for review
+SELECT id, :column1, _import_error
+FROM :staging_table
+WHERE _import_status = 'error';
+
+-- Drop staging table (automatic for TEMP, but explicit is clearer)
+DROP TABLE IF EXISTS :staging_table;