AIPassand@devpulse
e2c868084a
* feat(system): fix(windows-ci): combine pip bootstrap fix + venv activation in Verify step Combines both fixes needed to get windows-test.yml actually passing: 1. setup.sh: stop swallowing ensurepip errors (quiet + 2>/dev/null + || true was hiding real failures — pip was silently not installed). Add get-pip.py fallback and hard pip verification. 2. windows-test.yml: add 'source .venv/Scripts/activate' to Verify step. Each CI step gets a fresh shell — setup.sh's venv activation doesn't carry over, so drone wasn't on PATH in the subsequent step. Together, these should take Windows CI from the 'silent failure every run since creation' state to actually green. Supersedes PRs #330 and #331 which had the fixes on separate branches (neither green alone). Co-Authored-By: @devpulse <devpulse@aipass> * feat(system): chore(lint): ruff auto-fix sweep — 303 errors across 178 files (F401 unused imports + F541 f-string placeholders + F811 redefined); restored report_error re-export + added logger call in errors.py Co-Authored-By: @devpulse <devpulse@aipass> --------- Co-authored-by: @devpulse <devpulse@aipass>
262 lines
10 KiB
Python
262 lines
10 KiB
Python
# =================== AIPass ====================
|
|
# Name: spawn.py
|
|
# Description: Entry point CLI for drone @spawn
|
|
# Version: 1.0.0
|
|
# Created: 2026-03-05
|
|
# Modified: 2026-03-14
|
|
# =============================================
|
|
|
|
"""
|
|
SPAWN Branch - Agent Creation System
|
|
|
|
Creates new AIPass agents from templates.
|
|
Provides CLI interface to the spawn_agent() workflow.
|
|
"""
|
|
|
|
import sys
|
|
import argparse
|
|
|
|
from aipass.prax.apps.modules.logger import system_logger as logger
|
|
from aipass.cli.apps.modules import console, header, error, warning
|
|
|
|
|
|
def print_help():
|
|
"""Display Rich-formatted help."""
|
|
console.print()
|
|
header("SPAWN - Branch Lifecycle Manager")
|
|
console.print()
|
|
console.print("[dim]Create, update, and manage AIPass branches with class-scoped templates[/dim]")
|
|
console.print()
|
|
console.print("[bold cyan]USAGE:[/bold cyan]")
|
|
console.print()
|
|
console.print(" [dim]drone @spawn create [class] <target_path> [options][/dim]")
|
|
console.print(" [dim]drone @spawn passport <@dirname> [--role ...] [--purpose ...][/dim]")
|
|
console.print(" [dim]drone @spawn update <@branch | class --all> [--dry-run][/dim]")
|
|
console.print(" [dim]drone @spawn --help[/dim]")
|
|
console.print()
|
|
console.print("[bold cyan]COMMANDS:[/bold cyan]")
|
|
console.print()
|
|
console.print(" [green]create[/green] [class] <path> Create a new branch from template")
|
|
console.print(" [green]passport[/green] <@dirname> Grant birthright citizenship (minimal)")
|
|
console.print(" [green]update[/green] <@branch> Update single branch (uses its class)")
|
|
console.print(" [green]update[/green] <class> --all Update all branches of a class")
|
|
console.print(" [green]delete[/green] <@branch> Archive and deregister branch")
|
|
console.print(" [green]sync-registry[/green] Repair registry against filesystem")
|
|
console.print(" [green]sync-templates[/green] Pull managed files from source")
|
|
console.print(" [green]regenerate-registry[/green] Regenerate template registry hashes")
|
|
console.print()
|
|
console.print("[bold cyan]CITIZEN CLASSES:[/bold cyan]")
|
|
console.print()
|
|
console.print(" [green]builder[/green] Full 3-layer scaffold (apps/, modules/, handlers/) [dim][default][/dim]")
|
|
console.print(" [green]birthright[/green] Minimal citizenship (.trinity/, .aipass/, README.md)")
|
|
console.print()
|
|
console.print("[bold cyan]OPTIONS:[/bold cyan]")
|
|
console.print()
|
|
warning("--role", details="Agent role description")
|
|
warning("--traits", details="Agent personality traits")
|
|
warning("--purpose", details="Agent purpose (brief)")
|
|
warning("--template", details="Template class name (builder, birthright) or custom directory path")
|
|
warning("--registry", details="Path to AIPASS_REGISTRY.json")
|
|
warning("--dry-run", details="Preview changes without modifying files")
|
|
warning("--trace", details="Enable verbose logging")
|
|
console.print()
|
|
|
|
|
|
def handle_create(args):
|
|
"""Handle the create command with optional citizen class."""
|
|
from aipass.spawn.apps.modules.core import _spawn_agent as spawn_agent
|
|
from aipass.spawn.apps.modules.core import validate_class, get_default_class
|
|
|
|
if not args:
|
|
error("target path required", suggestion="drone @spawn create [class] <target_path> [--role ...]")
|
|
return 1
|
|
|
|
# Intercept --help before argparse (argparse has add_help=False)
|
|
if "--help" in args or "-h" in args:
|
|
print_help()
|
|
return 0
|
|
|
|
# Check if first arg is a citizen class
|
|
citizen_class = get_default_class()
|
|
remaining_args = args
|
|
if validate_class(args[0]):
|
|
citizen_class = args[0]
|
|
remaining_args = args[1:]
|
|
if not remaining_args:
|
|
error("target path required after class name")
|
|
return 1
|
|
|
|
dry_run = "--dry-run" in remaining_args
|
|
if dry_run:
|
|
remaining_args = [a for a in remaining_args if a != "--dry-run"]
|
|
|
|
parser = argparse.ArgumentParser(prog="spawn create", add_help=False)
|
|
parser.add_argument("target_path")
|
|
parser.add_argument("--role", default="")
|
|
parser.add_argument("--traits", default="")
|
|
parser.add_argument("--purpose", default="")
|
|
parser.add_argument("--template", default=None)
|
|
parser.add_argument("--registry", default=None)
|
|
|
|
parsed = parser.parse_args(remaining_args)
|
|
|
|
# --template can be a class name (e.g. "builder") or a raw path
|
|
template_dir = parsed.template
|
|
if parsed.template and validate_class(parsed.template):
|
|
citizen_class = parsed.template
|
|
template_dir = None
|
|
|
|
if dry_run:
|
|
return _dry_run_create(parsed.target_path, citizen_class, parsed)
|
|
|
|
result = spawn_agent(
|
|
target_path=parsed.target_path,
|
|
role=parsed.role,
|
|
traits=parsed.traits,
|
|
purpose=parsed.purpose,
|
|
template_dir=template_dir,
|
|
registry_path=parsed.registry,
|
|
citizen_class=citizen_class,
|
|
)
|
|
|
|
if result["success"]:
|
|
console.print()
|
|
console.print(f"[green]Agent created: {result['branch_name']}[/green]")
|
|
console.print(f" Class: {citizen_class}")
|
|
console.print(f" Path: {result['path']}")
|
|
console.print(f" Files: {result['files_copied']}")
|
|
console.print(f" Registry: {'updated' if result['registry_updated'] else 'not updated'}")
|
|
if result["validation_issues"]:
|
|
warning(f"{len(result['validation_issues'])} unreplaced placeholders")
|
|
console.print()
|
|
return 0
|
|
else:
|
|
error(result['error'])
|
|
return 1
|
|
|
|
|
|
def _dry_run_create(target_path, citizen_class, parsed):
|
|
"""Preview what create would do without making changes."""
|
|
from pathlib import Path
|
|
from aipass.spawn.apps.modules.core import _get_template_dir, get_branch_name, normalize_branch_name
|
|
|
|
target = Path(target_path).resolve()
|
|
template = _get_template_dir(citizen_class)
|
|
branch_name = get_branch_name(target)
|
|
branch_upper = normalize_branch_name(branch_name, "upper")
|
|
|
|
console.print()
|
|
header("DRY RUN — Create Preview")
|
|
console.print()
|
|
console.print(f" [bold]Branch:[/bold] {branch_upper}")
|
|
console.print(f" [bold]Class:[/bold] {citizen_class}")
|
|
console.print(f" [bold]Path:[/bold] {target}")
|
|
console.print(f" [bold]Template:[/bold] {template}")
|
|
if parsed.role:
|
|
console.print(f" [bold]Role:[/bold] {parsed.role}")
|
|
if parsed.purpose:
|
|
console.print(f" [bold]Purpose:[/bold] {parsed.purpose}")
|
|
|
|
if target.exists():
|
|
error(f"Target already exists: {target}")
|
|
return 1
|
|
|
|
if not template.exists():
|
|
error(f"Template not found: {template}")
|
|
return 1
|
|
|
|
# Count template files
|
|
file_count = sum(1 for f in template.rglob("*") if f.is_file() and "__pycache__" not in str(f))
|
|
dir_count = sum(1 for d in template.rglob("*") if d.is_dir() and "__pycache__" not in str(d))
|
|
|
|
console.print()
|
|
console.print(" [bold cyan]Would create:[/bold cyan]")
|
|
console.print(f" Files: ~{file_count}")
|
|
console.print(f" Directories: ~{dir_count}")
|
|
console.print(" Registry: add to AIPASS_REGISTRY.json")
|
|
console.print()
|
|
console.print(" [dim]No files were created. Remove --dry-run to execute.[/dim]")
|
|
console.print()
|
|
return 0
|
|
|
|
|
|
def print_introspection():
|
|
"""Display module introspection info."""
|
|
console.print()
|
|
console.print("spawn Entry Point")
|
|
console.print("Branch lifecycle manager — create, update, delete, and sync AIPass branches")
|
|
console.print()
|
|
console.print("Connected Modules:")
|
|
console.print(" modules/")
|
|
console.print(" - core.py (handle_command, _spawn_agent — agent creation orchestrator)")
|
|
console.print(" - update.py (handle_update — single/all branch updates)")
|
|
console.print(" - delete.py (handle_delete — archive and deregister branch)")
|
|
console.print(" - sync_registry.py (handle_sync_registry — registry repair)")
|
|
console.print(" - sync_templates.py (handle_sync_templates — template synchronization)")
|
|
console.print(" - regenerate_registry.py (handle_regenerate_registry — regenerate template registry)")
|
|
console.print(" - passport.py (handle_passport — grant birthright citizenship)")
|
|
console.print()
|
|
|
|
|
|
def main():
|
|
"""Main entry point."""
|
|
args = sys.argv[1:]
|
|
|
|
if len(args) == 0:
|
|
print_introspection()
|
|
return 0
|
|
|
|
if args[0] in ["--help", "-h", "help"]:
|
|
print_help()
|
|
return 0
|
|
|
|
if args[0] in ["--version", "-V"]:
|
|
console.print("SPAWN v1.0.0")
|
|
return 0
|
|
|
|
command = args[0]
|
|
remaining = args[1:] if len(args) > 1 else []
|
|
|
|
if command == "create":
|
|
return handle_create(remaining)
|
|
|
|
if command == "update":
|
|
from aipass.spawn.apps.modules.update import handle_update
|
|
return handle_update(remaining)
|
|
|
|
if command == "delete":
|
|
from aipass.spawn.apps.modules.delete import handle_delete
|
|
return handle_delete(remaining)
|
|
|
|
if command == "sync-registry":
|
|
from aipass.spawn.apps.modules.sync_registry import handle_sync_registry
|
|
return handle_sync_registry(remaining)
|
|
|
|
if command == "sync-templates":
|
|
from aipass.spawn.apps.modules.sync_templates import handle_sync_templates
|
|
return handle_sync_templates(remaining)
|
|
|
|
if command == "passport":
|
|
from aipass.spawn.apps.modules.passport import handle_passport
|
|
return handle_passport(remaining)
|
|
|
|
if command == "regenerate-registry":
|
|
from aipass.spawn.apps.modules.regenerate_registry import handle_regenerate_registry
|
|
return handle_regenerate_registry(remaining)
|
|
|
|
error(f"Unknown command: {command}", suggestion="Run 'drone @spawn --help' for available commands")
|
|
return 1
|
|
|
|
|
|
if __name__ == "__main__":
|
|
try:
|
|
sys.exit(main())
|
|
except KeyboardInterrupt:
|
|
logger.warning("SPAWN interrupted by user (KeyboardInterrupt)")
|
|
console.print("\n\nOperation cancelled by user")
|
|
sys.exit(0)
|
|
except Exception as e:
|
|
logger.error(f"SPAWN entry point error: {e}", exc_info=True)
|
|
console.print(f"\nError: {e}")
|
|
sys.exit(1)
|