REPOSITORY ARCHITECTURE

GitHub Repository Analysis: Deterministic Code & Architecture Audits

Catalayer Code Technical Manual•Updated 2026-10-18•8 min read

Evaluating open-source or commercial software repositories requires verifiable evidence, not probabilistic guesses. Catalayer Code analyzes public GitHub repositories using deterministic AST parsers, git commit delta analysis, and structural heuristics to evaluate structural gaps, test risk, and change reviewability.

DETERMINISTIC PRINCIPLES

Evaluation Foundations

01

Rule Assertion

Deterministic evidence takes precedence over probabilistic AI inference.

02

Rule Assertion

Every finding is anchored to verifiable repository artifacts: file paths, line diffs, or missing configuration files.

03

Rule Assertion

Checks evaluate structural health before generative models summarize context.

04

Rule Assertion

Analyses do not execute untrusted user code; all inspections are static and deterministic.

RULE MATRIX

Deterministic Check Signals

Specific verifiable repository conditions evaluated by Catalayer Code.

SIGNAL NAMEVERIFIED REPOSITORY CONDITIONCONFIDENCETARGET RISK MITIGATED
CI/CD Pipeline VerificationChecks presence of .github/workflows, .gitlab-ci.yml, or JenkinsfileHIGHUntested merges and unautomated build regressions
Lockfile ConsistencyValidates existence of package-lock.json, yarn.lock, Cargo.lock, or poetry.lockHIGHNon-deterministic dependency resolution and build drift
Test Directory AssociationInspects ratio of test files to implementation source modulesHIGHOmission of automated unit and integration verification

The Deterministic Imperative in Repository Audits

Many code intelligence tools pass entire codebases to large language models, prompting for "security vulnerabilities". This approach generates high false-positive rates and hallucinations, inventing line numbers and non-existent CVEs.

Catalayer Code reverses this sequence: it executes verifiable deterministic AST scanners first. If a repository lacks a CI pipeline, that is a proven boolean fact. Only after deterministic facts are established does AI provide contextual summaries.

The Three-Tier Inspection Hierarchy

1. Structural Layer: Scans repository root for manifest hygiene, license files, CI scripts, and security policy declarations.

2. Delta Layer: Inspects commit cadence, branch divergence, and file change concentration across recent git commits.

3. Reviewability Layer: Calculates cognitive review load based on diff dispersion and mixed-concern refactoring.

BOUNDARY & LIMITS

Explicit Technical Limitations

What this inspection method does not and cannot evaluate.

  • Does not perform runtime penetration testing or dynamic execution analysis.
  • Does not execute unit tests inside sandboxed containers.
  • Evaluates public git history and tree structures; does not evaluate private secrets stored in external vaults.

Inspect Any Public GitHub Repository

Run deterministic checks against any public repository without granting OAuth permissions. Review structural gaps, untested changes, and reviewability findings with evidence.

Frequently Asked Questions

Does Catalayer Code require GitHub OAuth permissions to inspect public repos?

No. Public repositories can be inspected anonymously via the public inspection API or the Chrome extension without granting write permissions or private repository access.

Related Developer Documentation