m4/org/openalice-ranker

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.

Features
5
Status
·unknown
Last activity
1mo ago
Branch
mvp

Architecture rating

D1mo ago
docsB-

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.

consistencyB-

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.

testingB-

~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 %.

reliabilityD

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.

securityD

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.

data layerD

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.

observabilityD

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.yml

Python CLI competitive-intelligence tool — scans rival AI projects, extracts features, fuzzy-matches gaps against the OpenAlice feature inventory, and scores priorities.

Runtime deps
  • openalice-atlasotheroptional
    via ATLAS_ORG_ROOT
    Consumes the OpenAlice feature inventory YAML produced by atlas to power 4-layer fuzzy gap detection and priority scoring.
Consumed env
  • GITHUB_TOKEN
Exposes
  • cli_binary: ranker
  • cli_binary: openalice-ranker
Env drift · manifest ⇄ code

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.

Manifest declares, code unused
  • GITHUB_TOKEN
Observed reads: 0 · declared: 1

Roadmap · what's planned next

0% avg5 goals
  • candidate-auto-discovery
    planned
    0%
    no description
  • incremental-collection
    planned
    0%
    no description
  • alias-db-growth
    planned
    0%
    no description
  • dashboard-live-mode
    planned
    0%
    no description
  • report-html-targets
    planned
    0%
    no description

Code composition

tokei · loc
107.2kloc
  • JSON63.4%
  • YAML35.0%
  • Python1.6%
  • TOML0.0%
  • JSON63.4%· 67,904
  • YAML35.0%· 37,556
  • Python1.6%· 1,692
  • TOML0.0%· 22
Language% codecodecommentsblanksfiles
JSON63.4%67,904009
YAML35.0%37,55610670710
Python1.6%1,6923735329
TOML0.0%22051
Markdown0.0%070,90519,459358
Plain Text0.0%0247345

Telemetry ribbon · last 90 days

1 event
MAYJUNJUL2026-06-10 · lifecycle · first scan — repo indexedNOW
commitmanifestlifecyclekind

ranker/cli

3 features
  • ranker.cli.collect
    src/ranker/cli.py:8
    no description
  • ranker.cli.inspect
    src/ranker/cli.py:13
    no description
  • ranker.cli.registry
    src/ranker/cli.py:3
    no description

ranker/pipeline

2 features
  • ranker.pipeline.collect
    src/ranker/__init__.py:3
    no description
  • ranker.pipeline.inspect
    src/ranker/__init__.py:8
    no description