openalice-ranker
Competitive intelligence pipeline for the OpenAlice ecosystem: collects source code, GitHub stats, and documentation from rival AI-agent projects, scores feature gaps with a weighted priority engine, and generates six specialized PDF reports.
Architecture rating
AGENTS.md + CLAUDE.md + README + GAPS.md, valid manifest (100) and 91 @feature annotations with clear summary; weakened by 60 missing docstrings and 61 missing type hints in source.
Zero circular deps, valid manifest (100/100), drift 90, uniform collector/registry/utils layout following org conventions; minor erosion from 5 dead imports and 14 unreferenced definitions.
~15 test modules covering collectors, registry, priority_scorer, reports, cli, dashboard, analysis, git and yaml_io — broad critical-path coverage; docked for 5 dead test imports and no reported coverage %.
5 bare/broad excepts swallow errors and no evidence of network timeouts/retries on git clone or HTTP collectors; CollectionStatus model suggests some state tracking, but no idempotency or graceful-shutdown signals — conservative given unknowns.
CLI tool with no authn/authz surface, but clones rival repos + fetches arbitrary websites (SSRF/command-injection surface in git_clone_shallow/WebsiteCollector) with no visible guards; GITHUB_TOKEN declared-but-unused (env drift) and 5 bare/broad excepts mask failures.
No relational DB — owns 0 tables, uses YAML/file registry (load_meta/save_meta) with no migrations, constraints, RLS or GDPR controls; acceptable for a file-based tool but the axis signals (schema/FK/tenant isolation) are essentially absent.
54 console/print statements instead of structured logging; no metrics, tracing, or health probes (Atlas health probe fails — no https endpoint, expected for a CLI), so operational visibility is print-only.
source · auto-grader-2026-06-16
Ecosystem manifest
.atlas-deps.ymlPython CLI competitive-intelligence tool — scans rival AI projects, extracts features, fuzzy-matches gaps against the OpenAlice feature inventory, and scores priorities.
- via ATLAS_ORG_ROOTConsumes the OpenAlice feature inventory YAML produced by atlas to power 4-layer fuzzy gap detection and priority scoring.
- GITHUB_TOKEN
- cli_binary: ranker
- cli_binary: openalice-ranker
Atlas grepped the repo's source for env reads (rust env::var · ts process.env · py os.environ · shell $VAR) and diffed against the manifest's consumes_env. Two lists below: stale declarations and undeclared reads.
- GITHUB_TOKEN
Roadmap · what's planned next
- candidate-auto-discoveryplanned0%no description
- incremental-collectionplanned0%no description
- alias-db-growthplanned0%no description
- dashboard-live-modeplanned0%no description
- report-html-targetsplanned0%no description
Code composition
tokei · loc- JSON63.4%
- YAML35.0%
- Python1.6%
- TOML0.0%
- JSON63.4%
- YAML35.0%
- Python1.6%
- TOML0.0%
- JSON63.4%· 67,904
- YAML35.0%· 37,556
- Python1.6%· 1,692
- TOML0.0%· 22
| Language | % code | code | comments | blanks | files |
|---|---|---|---|---|---|
| JSON | 63.4% | 67,904 | 0 | 0 | 9 |
| YAML | 35.0% | 37,556 | 106 | 707 | 10 |
| Python | 1.6% | 1,692 | 37 | 353 | 29 |
| TOML | 0.0% | 22 | 0 | 5 | 1 |
| Markdown | 0.0% | 0 | 70,905 | 19,459 | 358 |
| Plain Text | 0.0% | 0 | 247 | 34 | 5 |
Telemetry ribbon · last 90 days
1 eventranker/cli
3 features- ranker.cli.collectsrc/ranker/cli.py:8no description
- ranker.cli.inspectsrc/ranker/cli.py:13no description
- ranker.cli.registrysrc/ranker/cli.py:3no description
ranker/pipeline
2 features- ranker.pipeline.collectsrc/ranker/__init__.py:3no description
- ranker.pipeline.inspectsrc/ranker/__init__.py:8no description