feat(seedgo): docs(seedgo): fix README Commands/Usage section + update stats

Co-Authored-By: @seedgo <seedgo@aipass>
This commit is contained in:
AIOSAI
2026-04-26 10:04:51 -07:00
co-authored by @seedgo
parent fb66c6108c
commit aa1a0d4305
+18 -14
View File
@@ -2,7 +2,7 @@
# Seedgo
**Purpose:** Standards compliance platform for AIPass. Audits all 11 core agents against 33 code standards + diagnostics, manages bypass rules, runs proof certification, owns the hook system, and provides per-file checklist validation consumed by auto-fix hooks.
**Purpose:** Standards compliance platform for AIPass. Audits all 11 core agents against 34 code standards + diagnostics, manages bypass rules, runs proof certification, owns the hook system, and provides per-file checklist validation consumed by auto-fix hooks.
**Module:** `aipass.seedgo`
**Version:** 2.0.0
**Created:** 2026-03-05
@@ -12,7 +12,7 @@
## Overview
### What I Do
- Audit all 11 core agents against 33 code standards + diagnostics (architecture, CLI, imports, logging, naming, silent catch, deep nesting, etc.)
- Audit all 11 core agents against 34 code standards + diagnostics (architecture, CLI, imports, logging, naming, silent catch, deep nesting, etc.)
- Score files 0-100 per standard and report violations with actionable details
- Manage bypass rules (`.seedgo/bypass.json`) for deliberate exceptions
- Run pyright diagnostics across branches for type error detection
@@ -31,6 +31,8 @@
## Commands
All commands available via `drone @seedgo <command>` or `python3 -m aipass.seedgo <command>`.
### Via Drone (primary)
```bash
@@ -39,7 +41,7 @@ drone @seedgo --help # Full command listing
drone @seedgo --version # Version string
# Audit
drone @seedgo audit aipass # Audit all 11 agents (33 standards + diagnostics)
drone @seedgo audit aipass # Audit all 11 agents (34 standards + diagnostics)
drone @seedgo audit aipass @flow # Audit single branch
drone @seedgo audit inbox-ids # Inbox message-ID validation
@@ -110,7 +112,7 @@ seedgo/
│ │ ├── readme_update.py # README generation module
│ │ └── test_map.py # Custom function test coverage mapping
│ └── handlers/ # 11 handler directories
│ ├── aipass_standards/ # 33 checker standards (67 files)
│ ├── aipass_standards/ # 34 checker standards (67 files)
│ │ ├── *_check.py # Checker implementations (score 0-100)
│ │ ├── *_content.py # Queryable standard content
│ │ └── *.md # Standard documentation
@@ -134,7 +136,7 @@ seedgo/
│ ├── json/ # JSON tracking (json_handler)
│ ├── readme/ # README generator + branch resolution
│ └── test_map/ # Function test coverage scanner
├── tests/ # 26 test files, 495 tests
├── tests/ # 29 test files, 1131 tests
├── drone_adapter.py # Drone routing bridge
├── .trinity/ # Identity + memory
├── .seedgo/ # Self-bypass rules
@@ -155,7 +157,7 @@ seedgo/
---
## The 33 Standards
## The 34 Standards
| Standard | Scope | What It Checks |
|----------|-------|----------------|
@@ -169,6 +171,7 @@ seedgo/
| documentation | all_files | Docstrings on public functions |
| encapsulation | all_files | No cross-branch imports, proper isolation |
| error_handling | all_files | Try/except patterns, error propagation |
| handler_import | branch_level | apps/__init__.py contains `from . import handlers` |
| handlers | entry_point | Handler directory structure |
| hardcoded_key | all_files | No hardcoded API keys or secrets |
| help_text | all_files | --help content quality |
@@ -218,10 +221,10 @@ The `bridge` module (`drone @seedgo bridge install`) manages hook installation t
## Tests
- **26 test files**, **495 tests**, all passing
- **198 public functions**, 81 tested (41% coverage)
- **29 test files**, **1131 tests**, all passing
- **200 public functions**, 200 tested (100% coverage)
- **0 type errors** (pyright)
- Key test areas: standards audit, checklist, bypass, JSON handler, hooks (probe, track A/B/E, utility, bridge), proof, README, diagnostics
- Key test areas: standards audit, checklist, bypass, JSON handler, hooks (probe, track A/B/E, utility, bridge), proof, README, diagnostics, line coverage (plugin integrity, diagnostics, audit display, branch audit, architecture, checklist)
---
@@ -249,19 +252,20 @@ The `bridge` module (`drone @seedgo bridge install`) manages hook installation t
- `documentation_check.py` 5-line lookahead limitation for multi-line function signatures
- `dead_code_check.py` doesn't recognize `iterdir()` as valid discovery pattern
- Cross-branch file write detection recommended but not yet in standards (S73 finding)
- Test coverage at 41% — 117 public functions untested
- Test coverage: 200/200 public functions (100%) but line coverage still has gaps in 6 handler files
---
## Latest Audit (2026-04-22)
## Latest Audit (2026-04-26)
- **Seedgo score:** 100% (33/33 + diagnostics) — all standards green
- **Tests:** 495 passed, 0 failed, 0 skipped
- **Seedgo score:** 100% (34/34 + diagnostics) — all standards green
- **Tests:** 1131 passed, 0 failed, 0 skipped
- **Coverage:** 200 public functions, 200 tested (100%)
- **Type errors:** 0
---
**Last Updated:** 2026-04-22
**Last Updated:** 2026-04-26
---
[<- Back to AIPass](../../../README.md)