REPOSITORY INTELLIGENCE MANUAL

Deterministic Inspection & Evidence Architecture

Catalayer Code provides evidence-first evaluation for public GitHub repositories. Before applying generative AI workflows, it executes verifiable deterministic checks covering structural gaps, test coverage risk, and pull request reviewability.

CORE PHILOSOPHY

Core Operating Philosophy

Evidence first. Deterministic signals second. AI assistance third.

01

Deterministic Evidence

Evaluations begin by analyzing verifiable git history, repository structure, and file diffs. Every conclusion is anchored to specific repository artifacts rather than probabilistic guesses.

02

Local Scanner & Workspace

The Chrome extension executes immediate client-side checks directly on GitHub pages. Findings can be deepened in the Catalayer Code Workspace with audit trails and history.

03

Evidence Traceability

Every finding links to exact file paths, commit hashes, or line delta counts in the repository, protecting teams against black-box assertions.

CHECK CATALOG

Deterministic Check Rules

Verified repository signals evaluated during every inspection.

CHECK CATEGORYVERIFIED CONDITIONCONFIDENCETARGET RISK
Repository StructureDetects absence of CI workflow definitions (.github/workflows), license files, and lockfiles.HIGHUnverified build reproducibility & missing governance.
Test Coverage RiskSurfaces recent production source modifications committed without corresponding test file changes.HIGHSilent regressions and unverified functional drift.
PR ReviewabilityFlags high-churn or mixed-concern pull requests exceeding optimal single-pass review limits.MEDIUMReview fatigue, unspotted vulnerabilities, and merge delays.
Evidence TraceabilityEvery finding links to exact file paths, commit hashes, or line delta counts in the repository.HIGHBlack-box assertions and ungrounded hallucinations.
WORKFLOW INTEGRATION

Moving from Browser to Deep Workspace

Moving between in-browser GitHub browsing and full repository investigation.

STEP 1

GitHub In-Context

While browsing public repositories, the Chrome extension evaluates the open tree or active PR and renders deterministic badges.

STEP 2

Review Findings & Evidence

Inspect the highlighted signal, confidence score, and exact file list responsible for the alert.

STEP 3

Deeper Investigation in Workspace

Click "Open Workspace" to preserve the repository in local history, compare branches, and track multi-repository metrics.