diff --git a/src/aipass/seedgo/README.md b/src/aipass/seedgo/README.md index 5e2a14ba..5b10e4c3 100644 --- a/src/aipass/seedgo/README.md +++ b/src/aipass/seedgo/README.md @@ -1,36 +1,40 @@ # SEEDGO -**Purpose:** Enforce code standards through pluggable standard packs with 3-source discovery +**Purpose:** Standards compliance platform with pluggable standard packs **Module:** `aipass.seedgo` **Created:** 2026-03-05 +**Last Updated:** 2026-03-05 --- ## Overview ### What I Do - +Seedgo audits code against configurable standard packs. Ships with the `aipass` pack (20 standards). Routes commands to packs — each pack is self-contained with its own handlers, modules, and manifests. ### How I Work - **Entry Point:** `apps/seedgo.py` -- **Pattern:** Auto-discovers and routes to modules +- **Pattern:** Pack router — discovers packs, dispatches audit/verify/checklist commands --- ## Architecture ``` -SEEDGO/ +seedgo/ ├── apps/ -│ ├── seedgo.py # Entry point -│ ├── modules/ # Business logic -│ ├── handlers/ # Implementation -│ └── plugins/ # Extensions -├── docs/ +│ ├── seedgo.py # Entry point + pack router +│ ├── modules/ +│ │ └── seedgo_verify.py # Self-check module +│ ├── handlers/ +│ ├── plugins/ +│ └── standards/ +│ └── aipass/ # Built-in standard pack +│ ├── pack.json # Pack manifest (20 standards) +│ ├── pack_entry.py # Pack entry point +│ ├── handlers/ # Standard check implementations +│ └── modules/ # Standard orchestrators ├── tests/ -├── passport.json # Identity -├── local.json # Session history -├── observations.json # Collaboration patterns └── README.md ``` @@ -38,14 +42,30 @@ SEEDGO/ ## Commands -*Configure after initialization* +``` +seedgo --help # Show packs and usage +seedgo list # Show installed standard packs +seedgo verify # Self-check (5 checks) +seedgo audit # Run full standards audit +seedgo checklist # Check single file +``` + +--- + +## Standard Packs + +### aipass (built-in) +20 standards for AIPass framework modules: imports, architecture, naming, CLI, handlers, modules, documentation, error handling, testing, encapsulation, triggers, logging, permissions, META, README, JSON structure, type checking, CLI flags. + +Custom packs can be added to `apps/standards/` — each needs a `pack.json` manifest and `pack_entry.py`. --- ## Integration Points ### Depends On - +- `aipass.cli` — display formatting (Rich) +- `aipass.prax` — logging ### Provides To - +- All modules — standards auditing and compliance checking diff --git a/src/aipass/seedgo/apps/modules/seedgo_verify.py b/src/aipass/seedgo/apps/modules/seedgo_verify.py index 80fd99d5..36e24566 100755 --- a/src/aipass/seedgo/apps/modules/seedgo_verify.py +++ b/src/aipass/seedgo/apps/modules/seedgo_verify.py @@ -115,8 +115,8 @@ def run_verify() -> None: else: console.print(f"[green]✓[/green] Pack '{pack_dir.name}': all {len(standards)} standard check files present") checks_passed += 1 - except Exception: - pass + except Exception as e: + console.print(f"[red]✗[/red] Pack '{pack_dir.name}': verification error: {e}") # Summary console.print()