ArcSight Wedge

ArcSight v1 Status

This version is epistemically frozen.

Known limitations are documented and intentional. All future capability expansion occurs in v2.

See V1_STATUS.md for details.

ArcSight Wedge is the deterministic structural certainty engine that powers ArcSight.

It produces provable, reproducible structural facts about a codebase. It does not infer, score, or reassure.

Start Here

If you are new to ArcSight, start here:

👉 docs/adoption/README.md

This explains how to use ArcSight correctly and how to interpret silence.

Core Semantics

If you want to understand Arc's frozen semantics, models, and invariants:

👉 docs/core/ (constitutional documents)

Note: Core changes require steward approval. See docs/core/ENGINE_STEWARD.md.

ArcSight's epistemic core is feature-complete and closed. Innovation must occur outward from the core.

See RITUAL.md for the canonical ArcSight usage pattern.

CLI Usage

ArcSight Wedge is not a CLI.

To run ArcSight from the command line, use:

npx arcsight check .

or install:

npm install -g @arcsight-ai/cli

ArcSight is not a linter.

ArcSight is not advice.

ArcSight is structural truth.

That's it.

No capability lists.
No "what it detects".
No caching rules.
No confidence thresholds.
No implementation hints.

All of that either:

• belongs in /docs/core, or
• should not be user-facing at all.