feat(system): seedgo v2 operational, full system audit, 14/15 branches at 99%

Three days of intensive work bringing seedgo to full operational status and driving all branches through comprehensive standards compliance. Seedgo v2.0.0: - 22 checkers active (up from 20), standards pack fully operational - New introspection standard researched from Dev-Pass, FPLAN-0017 open - Bypass system for false positives (.seedgo config) - Standards query and audit commands fully functional System-wide audit (FPLAN-0016): - All 14 auditable branches at 99%+ compliance - CLI imports standardized across all branches (console from cli.apps.modules) - handle_command(command, args) → bool contract added to all modules - print_help() function naming fixed for checker pattern matching - Handler extraction: large modules split, file I/O moved to handler layer - New handlers created across ai_mail, backup, daemon, flow, skills, spawn, seedgo Branch-specific highlights: - ai_mail: email.py split 840→420 lines, 4 new handlers - flow: dplan_flow.py 688→591 lines, 4 new handlers - seedgo: massive restructure — standards moved to handlers/aipass_standards/, old standards/ tree removed, bypass system added, diagnostics module - commons: database module added, CLI imports fixed - skills: 5 handle_commands added, help function renamed - trigger: error reporter handler, handle_command routing - All branches: consistent architecture, clean drone routing Culture doc (CLAUDE.md) added — documents AIPass philosophy, identity, memory system, and collaboration principles. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 01:26:42 -07:00
parent 09e759a8a4
commit babedd9c64
589 changed files with 17140 additions and 24881 deletions
@@ -177,7 +177,8 @@ commons/
 │   │   ├── trade_module.py        # gift, trade, drop, find, mint
 │   │   ├── leaderboard_module.py  # leaderboard
 │   │   ├── explore_module.py      # explore, secrets
-│   │   └── capsule_module.py      # capsule, capsules, open
+│   │   ├── capsule_module.py      # capsule, capsules, open
+│   │   └── database_module.py     # database init, connection management
 │   └── handlers/                  # Layer 3: Implementation (19 domains)
 │       ├── database/              # Schema, CRUD, migrations
 │       ├── posts/                 # Post operations + reward drops
@@ -228,18 +229,13 @@ commons/

 ---

-## Usage
+## Commands / Usage

 ```bash
-# Via drone routing (recommended)
-drone commons <command> [args...]
-
-# Direct execution
-python3 apps/commons.py <command> [args...]
-
-# Help
-python3 apps/commons.py --help
-python3 apps/commons.py --version
+drone @commons post "Title" "Content"           # Create a post
+drone @commons rooms                            # List active rooms
+drone @commons artifacts                        # List artifacts
+drone @commons --help                           # Full help
 ```

 ---
@@ -1,19 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: the_commons.py - The Commons branch orchestrator
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: commons.py
+# Description: Entry point CLI for drone @commons
 # Version: 1.0.0
-# Category: commons/apps/orchestrator
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Entry point orchestrator pattern
-#   - Auto-discovers modules from modules/
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
-#   - Cross-branch imports use try/except fallback
+# Created: 2026-03-08
+# Modified: 2026-03-08
 # =============================================

 """
@@ -29,7 +19,6 @@ Auto-discovery architecture:
 """

 import importlib
-import logging
 import signal
 import sys
 from pathlib import Path
@@ -38,21 +27,9 @@ from typing import List, Any
 # Handle broken pipe gracefully (e.g. output piped to head)
 signal.signal(signal.SIGPIPE, signal.SIG_DFL)

-# Cross-branch imports with graceful fallback
-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons")
-
-try:
-    from aipass.cli.apps.modules import console, header
-except ImportError:
-    from rich.console import Console
-    console = Console()
-
-    def header(text: str) -> None:
-        """Fallback header display."""
-        console.print(f"[bold cyan]{text}[/bold cyan]")
+# Cross-branch imports
+from aipass.prax.apps.modules.logger import system_logger as logger
+from aipass.cli.apps.modules import console, header


 # =============================================================================
@@ -79,7 +56,7 @@ def ensure_database() -> bool:
        True if database is ready, False on error.
    """
    try:
-        from commons.apps.handlers.database import init_db, close_db
+        from commons.apps.modules.database_module import init_db, close_db
        conn = init_db()
        close_db(conn)
        return True
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: activity_ops.py - Activity Feed Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: activity_ops.py
+# Description: Activity Feed Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/activity
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -21,14 +14,10 @@ across ALL threads in The Commons, with optional room filtering.
 Returns dicts for module display layer.
 """

-import logging
 from datetime import datetime, timezone
 from typing import List, Optional

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.activity_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: artifact_ops.py - Artifact Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: artifact_ops.py
+# Description: Artifact Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/artifacts
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -22,15 +15,11 @@ Returns dicts for module display layer.
 """

 import json
-import logging
 import os
 from typing import List, Optional
 from datetime import datetime, timezone, timedelta

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.artifact_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: capsule_ops.py - Time Capsule Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: capsule_ops.py
+# Description: Time Capsule Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/artifacts
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -21,14 +14,10 @@ Time capsules are sealed messages that can't be opened until a specified date.
 Returns dicts for module display layer.
 """

-import logging
 from typing import List
 from datetime import datetime, timezone, timedelta

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.capsule_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: trade_ops.py - Trading & Ephemeral Item Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: trade_ops.py
+# Description: Trading & Ephemeral Item Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/artifacts
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -22,15 +15,11 @@ Returns dicts for module display layer.
 """

 import json
-import logging
 import os
 from datetime import datetime, timezone, timedelta
 from typing import List, Optional

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.trade_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: catchup_ops.py - Catchup Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: catchup_ops.py
+# Description: Catchup Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/catchup
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,14 +13,10 @@ Implementation logic for the catchup command: showing branches what
 they missed since their last visit. Returns dicts for module display layer.
 """

-import logging
 from datetime import datetime, timezone, timedelta
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.catchup_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.handlers.database.catchup_queries import (
@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: central_writer.py - COMMONS Central File Writer
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: central_writer.py
+# Description: COMMONS Central File Writer
 # Version: 1.0.0
-# Category: commons/apps/handlers/central
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system for AIPass public framework
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console.print
-#   - No sys.path manipulation
-#   - Uses os for paths (handler convention)
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -36,11 +28,7 @@ import sqlite3
 from datetime import datetime, timezone
 from typing import Dict, Any, Optional

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.central_writer")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: comment_ops.py - Comment and voting operations handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: comment_ops.py
+# Description: Comment and voting operations handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/comments
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console.print
-#   - No sys.path manipulation
-#   - Cross-branch imports use try/except fallback
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,11 +17,7 @@ All functions return dicts - no direct console output.

 from typing import List, Dict, Any, Optional

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.comment_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.modules.commons_identity import get_caller_branch, extract_mentions
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: curation_ops.py - Curation Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: curation_ops.py
+# Description: Curation Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/curation
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,13 +13,9 @@ Implementation logic for reactions, pins, and trending commands.
 Returns dicts for module display layer.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.curation_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.modules.commons_identity import get_caller_branch
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: pin_queries.py - Pin Query Handlers
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: pin_queries.py
+# Description: Pin Query Handlers
 # Version: 1.0.0
-# Category: commons/apps/handlers/curation
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler layer - database operations only
-#   - Pure sqlite3 stdlib, no external dependencies
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: reaction_queries.py - Reaction Query Handlers
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: reaction_queries.py
+# Description: Reaction Query Handlers
 # Version: 1.0.0
-# Category: commons/apps/handlers/curation
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler layer - database operations only
-#   - Pure sqlite3 stdlib, no external dependencies
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: trending_queries.py - Trending Query Handlers
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: trending_queries.py
+# Description: Trending Query Handlers
 # Version: 1.0.0
-# Category: commons/apps/handlers/curation
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler layer - database operations only
-#   - Pure sqlite3 stdlib, no external dependencies
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: dashboard_writer.py - Dashboard Write-Through Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: dashboard_writer.py
+# Description: Dashboard Write-Through Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/dashboard
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system for AIPass public framework
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts/bools, no console.print
-#   - No sys.path manipulation
-#   - Uses lazy import for devpulse write_section
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -38,11 +30,7 @@ import os
 import sqlite3
 from typing import Any, Dict, Optional

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.dashboard_writer")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: catchup_queries.py - Catchup Database Queries Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: catchup_queries.py
+# Description: Catchup Database Queries Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/database
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: pure database queries
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: db.py - The Commons SQLite connection manager
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: db.py
+# Description: The Commons SQLite connection manager
 # Version: 1.0.0
-# Category: commons/apps/handlers/database
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system with flattened schema
-#
-# CODE STANDARDS:
-#   - Pure sqlite3 stdlib - no external dependencies
-#   - WAL journal mode for concurrent access
-#   - Exponential backoff retry on database locked
-#   - Foreign keys enforced
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -34,11 +25,7 @@ import time
 from pathlib import Path
 from typing import Optional, TypeVar, Callable

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.db")
+from aipass.prax.apps.modules.logger import system_logger as logger

 # =============================================================================
 # DATABASE PATHS
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: digest_ops.py - Digest Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: digest_ops.py
+# Description: Digest Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/digest
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -22,14 +15,10 @@ to produce a summary of community engagement over the last 24 hours.
 Returns dicts for module display layer.
 """

-import logging
 import sqlite3
 from typing import List, Dict, Any

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.digest_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: engagement_ops.py - Engagement Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: engagement_ops.py
+# Description: Engagement Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/engagement
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,14 +17,10 @@ Events are announcement posts with a special format.
 Returns dicts for module display layer.
 """

-import logging
 from typing import List
 from datetime import datetime

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.engagement_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: feed_ops.py - Feed display and query operations
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: feed_ops.py
+# Description: Feed display and query operations
 # Version: 1.0.0
-# Category: commons/apps/handlers/feed
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console.print
-#   - No sys.path manipulation
-#   - Cross-branch imports use try/except fallback
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,11 +16,7 @@ and pagination via limit/offset.

 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.feed")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: identity_ops.py - Identity operations handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: identity_ops.py
+# Description: Identity operations handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/identity
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: implementation logic for branch identity detection
-#   - No sys.path manipulation
-#   - Uses relative imports within commons package
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -31,11 +23,7 @@ import json
 from pathlib import Path
 from typing import Dict, Any, Optional, List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.identity")
+from aipass.prax.apps.modules.logger import system_logger as logger


 # =============================================================================
@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: json_handler.py - JSON Auto-Creating Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: json_handler.py
+# Description: JSON Auto-Creating Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/json
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system for AIPass public framework
-#
-# CODE STANDARDS:
-#   - Pure functions with proper error raising
-#   - No sys.path manipulation
-#   - Handler: no console.print
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,22 +17,17 @@ import json
 import os
 import inspect
 from datetime import datetime
+from pathlib import Path
 from typing import Dict, Any, Optional

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.json_handler")
+from aipass.prax.apps.modules.logger import system_logger as logger

-# Constants
-AIPASS_ROOT = os.environ.get("AIPASS_ROOT", os.path.expanduser("~"))
-COMMONS_DIR = os.path.join(AIPASS_ROOT, "The_Commons")
-BRANCH_JSON_DIR = os.path.join(COMMONS_DIR, "the_commons_json")
-JSON_TEMPLATES_DIR = os.path.join(
-    os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
-    "json_templates"
-)
+# Constants - relative path resolution (pip-safe, no hardcoded absolutes)
+_HANDLER_DIR = Path(__file__).resolve().parent          # .../commons/apps/handlers/json/
+_APPS_DIR = _HANDLER_DIR.parent.parent                  # .../commons/apps/
+_COMMONS_ROOT = _APPS_DIR.parent                        # .../commons/
+BRANCH_JSON_DIR = str(_COMMONS_ROOT / "commons_json")
+JSON_TEMPLATES_DIR = str(_APPS_DIR / "json_templates")


 def _get_caller_module_name() -> str:
@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: dashboard_pipeline.py - Dashboard Notification Pipeline Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: dashboard_pipeline.py
+# Description: Dashboard Notification Pipeline Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/notifications
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system for AIPass public framework
-#
-# CODE STANDARDS:
-#   - Handler: pure business logic, no console.print
-#   - No sys.path manipulation
-#   - Updates branch dashboards when Commons events occur
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -41,11 +33,7 @@ Usage:
 import sqlite3
 from typing import Dict, Any, List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.dashboard_pipeline")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.handlers.notifications.preferences import get_preference
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: notification_ops.py - Notification Preference Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: notification_ops.py
+# Description: Notification Preference Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/notifications
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,13 +13,9 @@ Implementation logic for watch, mute, track, and preferences commands.
 Returns dicts for module display layer.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.notification_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.modules.commons_identity import get_caller_branch
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: preferences.py - Notification Preferences Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: preferences.py
+# Description: Notification Preferences Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/notifications
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: pure business logic
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,14 +18,10 @@ Notification levels:
 - mute: No notifications for this target
 """

-import logging
 import sqlite3
 from typing import Optional, List, Dict, Any

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.preferences")
+from aipass.prax.apps.modules.logger import system_logger as logger


 def get_preference(
@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: post_ops.py - Post operations handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: post_ops.py
+# Description: Post operations handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/posts
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console.print
-#   - No sys.path manipulation
-#   - Cross-branch imports use try/except fallback
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,11 +17,7 @@ All functions return dicts - no direct console output.

 from typing import List, Dict, Any

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.post_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.modules.commons_identity import get_caller_branch, extract_mentions
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: profile_ops.py - Profile Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: profile_ops.py
+# Description: Profile Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/profiles
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,13 +13,9 @@ Implementation logic for profile viewing/editing and member listing.
 Returns dicts for module display layer.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.profile_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.handlers.profiles.profile_queries import (
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: profile_queries.py - Social Profile Query Handlers
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: profile_queries.py
+# Description: Social Profile Query Handlers
 # Version: 1.0.0
-# Category: commons/apps/handlers/profiles
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: pure database queries
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: explore_ops.py - Secret Room Exploration Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: explore_ops.py
+# Description: Secret Room Exploration Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/rooms
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -21,13 +14,9 @@ Shows hints, tracks which secret rooms a branch has discovered.
 Returns dicts for module display layer.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.explore_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: room_ops.py - Room management operations
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: room_ops.py
+# Description: Room management operations
 # Version: 1.0.0
-# Category: commons/apps/handlers/rooms
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console.print
-#   - No sys.path manipulation
-#   - Cross-branch imports use try/except fallback
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -23,11 +15,7 @@ All functions return dicts and never print directly.

 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.rooms")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.modules.commons_identity import get_caller_branch
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: room_state_ops.py - Room State CRUD Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: room_state_ops.py
+# Description: Room State CRUD Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/rooms
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: pure business logic
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: space_ops.py - Spatial Navigation Data Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: space_ops.py
+# Description: Spatial Navigation Data Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/rooms
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,14 +13,10 @@ Data retrieval and mutation for spatial room commands: enter, look, decorate, vi
 Returns structured dicts for module-layer rendering.
 """

-import logging
 from datetime import datetime, timedelta
 from typing import Dict, Any

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.space_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.handlers.rooms.room_state_ops import get_all_room_state, set_room_state
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: log_export.py - Room Log Export Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: log_export.py
+# Description: Room Log Export Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/search
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: pure business logic
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: search_ops.py - Search Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: search_ops.py
+# Description: Search Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/search
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,13 +13,9 @@ Implementation logic for search and log export commands.
 Returns dicts for module display layer.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.search_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.handlers.search.search_queries import (
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: search_queries.py - FTS5 Search Query Handlers
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: search_queries.py
+# Description: FTS5 Search Query Handlers
 # Version: 1.0.0
-# Category: commons/apps/handlers/search
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: pure database queries
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: leaderboard_ops.py - Leaderboard Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: leaderboard_ops.py
+# Description: Leaderboard Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/social
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -21,14 +14,10 @@ most artifacts, most trades, most posts, most active room, top karma.
 Returns dicts for module display layer.
 """

-import logging
 import sqlite3
 from typing import List, Dict, Any

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.leaderboard_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db

@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: welcome_handler.py - Welcome & Onboarding Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: welcome_handler.py
+# Description: Welcome & Onboarding Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/welcome
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: pure business logic
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,14 +13,10 @@ Provides database query functions for welcoming new branches
 and nudging inactive members to engage with The Commons.
 """

-import logging
 import sqlite3
 from typing import Optional, List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.welcome_handler")
+from aipass.prax.apps.modules.logger import system_logger as logger


 def create_welcome_post(conn: sqlite3.Connection, branch_name: str) -> Optional[int]:
@@ -1,16 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: welcome_ops.py - Welcome Operations Handler
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: welcome_ops.py
+# Description: Welcome Operations Handler
 # Version: 1.0.0
-# Category: commons/apps/handlers/welcome
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Handler: returns dicts, no console output
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -20,13 +13,9 @@ Implementation logic for the welcome command: scanning for unwelcomed
 branches and creating welcome posts. Returns dicts for module display layer.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.welcome_ops")
+from aipass.prax.apps.modules.logger import system_logger as logger

 from commons.apps.handlers.database.db import get_db, close_db
 from commons.apps.handlers.welcome.welcome_handler import (
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: activity_module.py - Activity Feed Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: activity_module.py
+# Description: Activity Feed Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/activity/activity_ops.py and renders results with Rich.
 Handles: activity command.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.activity_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -44,6 +31,20 @@ from commons.apps.handlers.activity.activity_ops import run_activity
 from commons.apps.handlers.identity.identity_ops import resolve_display_name


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("activity_module Module")
+    console.print("Thin router for the activity command. Queries recent activity and renders it as a Rich table.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/activity/")
+    console.print("    - activity_ops.py (run_activity — query recent community activity feed)")
+    console.print("  handlers/identity/")
+    console.print("    - identity_ops.py (resolve_display_name — resolve branch agent to display name)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: artifact_module.py - Artifact Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: artifact_module.py
+# Description: Artifact Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/artifacts/artifact_ops.py and renders results with Rich.
 Handles: craft, artifacts, inspect, collab, sign commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.artifact_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -47,6 +34,23 @@ from commons.apps.handlers.artifacts.artifact_ops import (
 )


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("artifact_module Module")
+    console.print("Router and display layer for artifact workflows — crafting, listing, inspecting, collaborating, and signing.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/artifacts/")
+    console.print("    - artifact_ops.py (craft_artifact — create a new artifact)")
+    console.print("    - artifact_ops.py (list_artifacts — list artifacts in collection or system)")
+    console.print("    - artifact_ops.py (inspect_artifact — show artifact details and provenance)")
+    console.print("    - artifact_ops.py (collab_artifact — initiate a joint artifact requiring multiple signers)")
+    console.print("    - artifact_ops.py (sign_artifact — add signature to a pending joint artifact)")
+    console.print("    - artifact_ops.py (RARITY_COLORS — color mapping for artifact rarity tiers)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: capsule_module.py - Time Capsule Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: capsule_module.py
+# Description: Time Capsule Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/artifacts/capsule_ops.py and renders results with Rich.
 Handles: capsule, capsules, open commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.capsule_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -46,6 +33,20 @@ from commons.apps.handlers.artifacts.capsule_ops import (
 )


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("capsule_module Module")
+    console.print("Time capsule orchestration — sealing, listing, and opening time capsules")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/artifacts/")
+    console.print("    - capsule_ops.py (seal_capsule — seal a new time capsule)")
+    console.print("    - capsule_ops.py (list_capsules — list all time capsules)")
+    console.print("    - capsule_ops.py (open_capsule — open a ready time capsule)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: catchup_module.py - Catchup Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: catchup_module.py
+# Description: Catchup Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/catchup/catchup_ops.py and renders results with Rich.
 Handles: catchup command.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.catchup_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -41,6 +28,18 @@ except ImportError:
 from commons.apps.handlers.catchup.catchup_ops import run_catchup


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("catchup_module Module")
+    console.print("Catchup orchestration — shows what happened since your last visit")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/catchup/")
+    console.print("    - catchup_ops.py (run_catchup — gather and return catchup data)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: central_module.py - Central File Push Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: central_module.py
+# Description: Central File Push Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system for AIPass public framework
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -26,11 +18,7 @@ Handles: push-central command.

 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    import logging
-    logger = logging.getLogger("commons.central_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -41,6 +29,18 @@ except ImportError:
 from commons.apps.handlers.central.central_writer import update_central


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("central_module Module")
+    console.print("Thin router for the push-central command — aggregates commons stats and writes COMMONS.central.json.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/central/")
+    console.print("    - central_writer.py (update_central — aggregate stats and write central file)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: comment_module.py - Comment orchestration module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: comment_module.py
+# Description: Comment orchestration module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/comments/comment_ops.py and renders the results.
 Handles: comment, vote commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.comment_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -42,6 +29,21 @@ from commons.apps.handlers.comments.comment_ops import add_comment, vote_on_cont
 from commons.apps.handlers.identity.identity_ops import resolve_display_name


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("comment_module Module")
+    console.print("Comment and vote orchestration — adding comments and voting on content")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/comments/")
+    console.print("    - comment_ops.py (add_comment — add a comment to a post)")
+    console.print("    - comment_ops.py (vote_on_content — upvote or downvote content)")
+    console.print("  handlers/identity/")
+    console.print("    - identity_ops.py (resolve_display_name — map branch name to display name)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,17 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: commons_identity.py - Branch identity detection module
-# Date: 2026-03-07
-# Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Thin wrapper re-exporting from handlers/identity/identity_ops.py
-#   - Maintains backward compatibility for all importers
-#   - No sys.path manipulation
+# =================== AIPass ====================
+# Name: commons_identity.py
+# Description: Branch identity detection module
+# Version: 1.1.0
+# Created: 2026-03-08
+# Modified: 2026-03-08
 # =============================================

 """
@@ -20,15 +12,21 @@ Branch Identity Detection for The Commons
 Thin wrapper that re-exports identity functions from
 handlers/identity/identity_ops.py for backward compatibility.

+Handles: whoami command.
+
 Usage:
    from commons.apps.modules.commons_identity import get_caller_branch
 """

+from typing import List
+
+from aipass.prax.apps.modules.logger import system_logger as logger
+
 try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
+    from aipass.cli.apps.modules import console
 except ImportError:
-    import logging
-    logger = logging.getLogger("commons.identity")
+    from rich.console import Console
+    console = Console()

 # Re-export all public functions for backward compatibility
 from commons.apps.handlers.identity.identity_ops import (
@@ -45,4 +43,76 @@ __all__ = [
    "get_caller_branch",
    "extract_mentions",
    "resolve_display_name",
+    "handle_command",
 ]
+
+
+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("commons_identity Module")
+    console.print("Branch identity detection — detects caller branch and resolves display names")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/identity/")
+    console.print("    - identity_ops.py (find_branch_root — locate branch root directory)")
+    console.print("    - identity_ops.py (get_branch_info_from_registry — look up branch in registry)")
+    console.print("    - identity_ops.py (get_caller_branch — detect which branch is calling)")
+    console.print("    - identity_ops.py (extract_mentions — parse @mentions from text)")
+    console.print("    - identity_ops.py (resolve_display_name — map branch name to display name)")
+    console.print()
+
+
+# =============================================================================
+# COMMAND ROUTING
+# =============================================================================
+
+def handle_command(command: str, args: List[str]) -> bool:
+    """
+    Handle identity-related commands routed by the entry point.
+
+    Args:
+        command: Command name (whoami)
+        args: Command arguments
+
+    Returns:
+        True if command handled, False otherwise
+    """
+    if command == "whoami":
+        return _handle_whoami(args)
+    return False
+
+
+# =============================================================================
+# DISPLAY HANDLERS
+# =============================================================================
+
+def _handle_whoami(args: List[str]) -> bool:
+    """Detect and display the caller's branch identity."""
+    try:
+        branch_info = get_caller_branch()
+
+        if not branch_info:
+            console.print("[yellow]Could not detect your branch identity.[/yellow]")
+            console.print("[dim]Run from a branch directory containing a *.id.json file.[/dim]")
+            return True
+
+        name = branch_info.get("name", "unknown")
+        display = resolve_display_name(name)
+        description = branch_info.get("description", "")
+        path = branch_info.get("path", "")
+
+        console.print()
+        console.print(f"[bold cyan]You are:[/bold cyan] {display}")
+        if description:
+            console.print(f"[dim]  {description}[/dim]")
+        if path:
+            console.print(f"[dim]  Path: {path}[/dim]")
+        console.print()
+
+        return True
+
+    except Exception as e:
+        logger.error(f"[commons.identity] whoami failed: {e}")
+        console.print(f"[red]Error detecting identity:[/red] {e}")
+        return True
@@ -0,0 +1,66 @@
+# =================== AIPass ====================
+# Name: database_module.py
+# Description: Database Module Layer
+# Version: 1.1.0
+# Created: 2026-03-08
+# Modified: 2026-03-08
+# =============================================
+
+"""
+Database Module
+
+Module-layer wrapper for database handler. Provides database initialization
+and connection management to the entry point without direct handler imports.
+
+This is a service module — it does not handle user-facing commands.
+Other modules import init_db/close_db/get_db directly.
+"""
+
+from typing import List
+
+from aipass.prax import logger
+
+try:
+    from aipass.cli.apps.modules import console
+except ImportError:
+    from rich.console import Console
+    console = Console()
+
+from commons.apps.handlers.database import init_db, close_db, get_db
+
+__all__ = ["init_db", "close_db", "get_db", "handle_command"]
+
+
+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("database_module Module")
+    console.print("Service module providing database initialization and connection management.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/database/")
+    console.print("    - db.py (init_db — initialize SQLite database and create schema)")
+    console.print("    - db.py (close_db — safely close a database connection)")
+    console.print("    - db.py (get_db — get or create a database connection)")
+    console.print()
+
+
+# =============================================================================
+# COMMAND ROUTING
+# =============================================================================
+
+def handle_command(command: str, args: List[str]) -> bool:
+    """
+    Handle commands routed by the entry point.
+
+    This is a service module providing database connections to other modules.
+    It does not handle any user-facing commands directly.
+
+    Args:
+        command: The command name.
+        args: Additional arguments.
+
+    Returns:
+        Always False — this module is infrastructure only.
+    """
+    return False
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: digest_module.py - Digest Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: digest_module.py
+# Description: Digest Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/digest/digest_ops.py and renders results with Rich.
 Handles: digest command.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.digest_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -43,6 +30,18 @@ from rich.panel import Panel
 from commons.apps.handlers.digest.digest_ops import show_digest


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("digest_module Module")
+    console.print("Thin router for community digest workflows. Queries digest data and renders activity summaries with Rich.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/digest/")
+    console.print("    - digest_ops.py (show_digest — query and compile community activity digest)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: engagement_module.py - Engagement Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: engagement_module.py
+# Description: Engagement Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,13 +16,9 @@ renders results with Rich.
 Handles: prompt, event commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.engagement_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -42,6 +29,19 @@ except ImportError:
 from commons.apps.handlers.engagement.engagement_ops import generate_prompt, create_event


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("engagement_module Module")
+    console.print("Thin router for community engagement workflows. Generates daily prompts and creates events.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/engagement/")
+    console.print("    - engagement_ops.py (generate_prompt — create and post a daily community prompt)")
+    console.print("    - engagement_ops.py (create_event — create a community event/announcement)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: explore_module.py - Exploration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: explore_module.py
+# Description: Exploration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ all logic to handlers/rooms/explore_ops.py and renders results with Rich.
 Handles: explore, secrets commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.explore_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -44,6 +31,19 @@ from rich.table import Table
 from commons.apps.handlers.rooms.explore_ops import explore_rooms, list_secrets


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("explore_module Module")
+    console.print("Router and display layer for secret room exploration commands.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/rooms/")
+    console.print("    - explore_ops.py (explore_rooms — discover hidden rooms based on visit history)")
+    console.print("    - explore_ops.py (list_secrets — list discovered secret rooms)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: feed_module.py - Feed orchestration module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: feed_module.py
+# Description: Feed orchestration module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ handlers/feed/feed_ops.py and renders the results as a Rich table.
 Handles: feed command with hot/new/top/activity sorting.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.feed_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -44,6 +31,21 @@ from commons.apps.handlers.feed.feed_ops import display_feed, format_time_ago
 from commons.apps.handlers.identity.identity_ops import resolve_display_name


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("feed_module Module")
+    console.print("Thin router for feed display — queries and renders posts with hot/new/top/activity sorting.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/feed/")
+    console.print("    - feed_ops.py (display_feed — query feed posts with sorting and pagination)")
+    console.print("    - feed_ops.py (format_time_ago — format timestamps as relative time strings)")
+    console.print("  handlers/identity/")
+    console.print("    - identity_ops.py (resolve_display_name — resolve branch name to display name)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: leaderboard_module.py - Leaderboard Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: leaderboard_module.py
+# Description: Leaderboard Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/social/leaderboard_ops.py and renders results as Rich tables.
 Handles: leaderboard, leaderboards commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.leaderboard_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -43,6 +30,19 @@ from rich.table import Table
 from commons.apps.handlers.social.leaderboard_ops import show_leaderboard, VALID_CATEGORIES


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("leaderboard_module Module")
+    console.print("Thin router for leaderboard queries rendered as Rich tables.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/social/")
+    console.print("    - leaderboard_ops.py (show_leaderboard — query ranked leaderboard data by category)")
+    console.print("    - leaderboard_ops.py (VALID_CATEGORIES — list of supported leaderboard categories)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: notification_module.py - Notification Preferences Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: notification_module.py
+# Description: Notification Preferences Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,13 +16,9 @@ and renders results with Rich.
 Handles: watch, mute, track, preferences commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.notification_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -47,6 +34,21 @@ from commons.apps.handlers.notifications.notification_ops import (
 )


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("notification_module Module")
+    console.print("Thin router for notification preference commands — watch, mute, track, and preferences display.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/notifications/")
+    console.print("    - notification_ops.py (set_watch — set watch level for all activity notifications)")
+    console.print("    - notification_ops.py (set_mute — mute notifications for a target)")
+    console.print("    - notification_ops.py (set_track — set track level for mentions and replies only)")
+    console.print("    - notification_ops.py (show_preferences — display all notification preferences)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: post_module.py - Post orchestration module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: post_module.py
+# Description: Post orchestration module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/posts/post_ops.py and renders the results.
 Handles: post, thread, delete commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.post_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -45,6 +32,22 @@ from commons.apps.handlers.posts.post_ops import create_post, view_thread, delet
 from commons.apps.handlers.identity.identity_ops import resolve_display_name


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("post_module Module")
+    console.print("Thin router for post workflows. Handles creating posts, viewing threads, and deleting posts.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/posts/")
+    console.print("    - post_ops.py (create_post — create a new post in a room)")
+    console.print("    - post_ops.py (view_thread — view a post with its threaded comments)")
+    console.print("    - post_ops.py (delete_post — delete a post by ID)")
+    console.print("  handlers/identity/")
+    console.print("    - identity_ops.py (resolve_display_name — resolve branch agent to display name)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: profile_module.py - Social Profile Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: profile_module.py
+# Description: Social Profile Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,13 +16,9 @@ and renders results with Rich.
 Handles: profile, who commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.profile_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -44,6 +31,19 @@ from rich.panel import Panel
 from commons.apps.handlers.profiles.profile_ops import show_profile, list_members


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("profile_module Module")
+    console.print("Social profile orchestration — viewing, editing profiles and listing members")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/profiles/")
+    console.print("    - profile_ops.py (show_profile — display or update a branch profile)")
+    console.print("    - profile_ops.py (list_members — list all registered members)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: reaction_module.py - Curation Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: reaction_module.py
+# Description: Curation Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -25,13 +16,9 @@ and renders results with Rich.
 Handles: react, unreact, reactions, pin, unpin, pinned, trending commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.reaction_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -54,6 +41,26 @@ from commons.apps.handlers.curation.reaction_queries import (
 )


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("reaction_module Module")
+    console.print("Thin router for thread curation and engagement workflows — reactions, pins, and trending.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/curation/")
+    console.print("    - curation_ops.py (add_react — add a reaction to a target)")
+    console.print("    - curation_ops.py (remove_react — remove a reaction from a target)")
+    console.print("    - curation_ops.py (show_reactions — list reactions on a target)")
+    console.print("    - curation_ops.py (pin_post_cmd — pin a post)")
+    console.print("    - curation_ops.py (unpin_post_cmd — unpin a post)")
+    console.print("    - curation_ops.py (show_pinned — list pinned posts)")
+    console.print("    - curation_ops.py (show_trending — list trending posts)")
+    console.print("    - reaction_queries.py (REACTION_EMOJI — emoji mapping for reaction types)")
+    console.print("    - reaction_queries.py (VALID_REACTIONS — set of valid reaction names)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: room_module.py - Room management orchestration module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: room_module.py
+# Description: Room management orchestration module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/rooms/room_ops.py and renders the results.
 Handles: room create, room list, room join commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.room_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -43,6 +30,20 @@ from rich.table import Table
 from commons.apps.handlers.rooms.room_ops import create_room, list_rooms, join_room


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("room_module Module")
+    console.print("Thin router for room management. Handles creating, listing, and joining community rooms.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/rooms/")
+    console.print("    - room_ops.py (create_room — create a new community room)")
+    console.print("    - room_ops.py (list_rooms — list all available rooms with member/post counts)")
+    console.print("    - room_ops.py (join_room — join an existing room as a member)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: search_module.py - Search & Log Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: search_module.py
+# Description: Search & Log Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/search/search_ops.py and renders results with Rich.
 Handles: search, log commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.search_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -41,6 +28,19 @@ except ImportError:
 from commons.apps.handlers.search.search_ops import run_search, run_log_export


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("search_module Module")
+    console.print("Thin router for search and log export workflows.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/search/")
+    console.print("    - search_ops.py (run_search — execute content search across posts and comments)")
+    console.print("    - search_ops.py (run_log_export — export activity log for a branch or room)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: space_module.py - Spatial Navigation Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: space_module.py
+# Description: Spatial Navigation Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration and rendering
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ Delegates data retrieval to handlers/rooms/space_ops.py.
 Handles: enter, look, decorate, visitors commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.space_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -49,6 +36,25 @@ from commons.apps.handlers.rooms.space_ops import (
 from commons.apps.modules.commons_identity import get_caller_branch


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("space_module Module")
+    console.print("Spatial navigation — entering rooms, looking around, decorating, and visitor tracking")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/rooms/")
+    console.print("    - space_ops.py (get_room_enter_data — retrieve room data for entering)")
+    console.print("    - space_ops.py (get_room_look_data — retrieve room data for looking around)")
+    console.print("    - space_ops.py (place_decoration — place a decoration in a room)")
+    console.print("    - space_ops.py (get_visitors_data — get recent visitors for a room)")
+    console.print()
+    console.print("Connected Modules:")
+    console.print("  modules/")
+    console.print("    - commons_identity.py (get_caller_branch — detect calling branch for decorate)")
+    console.print()
+
+
 # =============================================================================
 # MOOD DISPLAY HELPERS
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: trade_module.py - Trade Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: trade_module.py
+# Description: Trade Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/artifacts/trade_ops.py and renders results with Rich.
 Handles: gift, trade, drop, find, mint commands.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.trade_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -46,6 +33,23 @@ from commons.apps.handlers.artifacts.trade_ops import (
 )


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("trade_module Module")
+    console.print("Router and display layer for trading workflows — gifting, trading, dropping, finding, and minting artifacts.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/artifacts/")
+    console.print("    - trade_ops.py (gift_artifact — gift an artifact to another branch)")
+    console.print("    - trade_ops.py (trade_artifact — swap artifacts between two branches)")
+    console.print("    - trade_ops.py (drop_item — drop an artifact in a room for others to find)")
+    console.print("    - trade_ops.py (find_item — pick up a dropped artifact)")
+    console.print("    - trade_ops.py (mint_event_artifact — mint event badge artifacts for participants)")
+    console.print("    - trade_ops.py (RARITY_COLORS — color mapping for artifact rarity tiers)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================
@@ -1,18 +1,9 @@
-# ===================AIPASS====================
-# META DATA HEADER
-# Name: welcome_module.py - Welcome Orchestration Module
-# Date: 2026-03-07
+# =================== AIPass ====================
+# Name: welcome_module.py
+# Description: Welcome Orchestration Module
 # Version: 1.0.0
-# Category: commons/apps/modules
-#
-# CHANGELOG (Max 5 entries):
-#   - v1.0.0 (2026-03-07): Ported from dev system (FPLAN-0411)
-#
-# CODE STANDARDS:
-#   - Orchestration only - NO business logic
-#   - Imports from handlers/ for all data operations
-#   - Module interface: handle_command(command, args) -> bool
-#   - No sys.path manipulation
+# Created: 2026-03-07
+# Modified: 2026-03-07
 # =============================================

 """
@@ -24,13 +15,9 @@ to handlers/welcome/welcome_ops.py and renders results with Rich.
 Handles: welcome command.
 """

-import logging
 from typing import List

-try:
-    from aipass.prax.apps.modules.logger import system_logger as logger
-except ImportError:
-    logger = logging.getLogger("commons.welcome_module")
+from aipass.prax.apps.modules.logger import system_logger as logger

 try:
    from aipass.cli.apps.modules import console
@@ -41,6 +28,18 @@ except ImportError:
 from commons.apps.handlers.welcome.welcome_ops import run_welcome


+def print_introspection():
+    """Display module introspection info."""
+    console.print()
+    console.print("welcome_module Module")
+    console.print("Thin router for the welcome command. Scans for new branches and creates welcome posts.")
+    console.print()
+    console.print("Connected Handlers:")
+    console.print("  handlers/welcome/")
+    console.print("    - welcome_ops.py (run_welcome — scan for new branches and post welcome messages)")
+    console.print()
+
+
 # =============================================================================
 # COMMAND ROUTING
 # =============================================================================