Fix seedgo README and silent failure in verify
- README: add real content (commands, architecture, pack docs, Last Updated date, seedgo_verify module mention) - seedgo_verify: replace silent except:pass with error reporting Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.6
parent
63627c1e81
commit
f6341c5f50
+35
-15
@@ -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 <pack> # Run full standards audit
|
||||
seedgo checklist <pack> <file> # 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
|
||||
|
||||
@@ -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()
|
||||
|
||||
Reference in New Issue
Block a user