Metadata-Version: 2.4
Name: sca-unit
Version: 0.4.0
Summary: Structural compatibility assessment prototype
Author: Bassam Alkarishy
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# SCA-Unit

SCA-Unit is a structural assessment prototype designed to compare two system representations as structures rather than as isolated values.

It accepts two structural descriptions in JSON format and produces a deterministic assessment report containing:

- Node similarity
- Edge similarity
- Structural compatibility
- Shared-domain conflict
- A structural verdict

The current public prototype intentionally excludes proprietary structural consolidation, optimization, self-evolution, and protected decision mechanisms.

---

## Current Version

0.4.0

## Local Demo Package

Run the local browser demo with:

.\run_demo.ps1

The demo opens http://127.0.0.1:8765 and uses SCA_UNIT_API_KEY from .env.local.

## First-time setup after extraction

Before running the demo, create a local environment file named .env.local in the project root with this content:

SCA_UNIT_API_KEY=sca-unit-demo-key-2026-secure-local-001

This file is intentionally excluded from the public ZIP package.

## Demo Examples

Use these files for a quick browser demo:

- demo_examples/baseline_user.json
- demo_examples/changed_user.json

Paste baseline_user.json into the first JSON box and changed_user.json into the second JSON box, then click Compare structures.


---

## Command Line Usage

Show the installed version:

sca-unit --version

Run a full structural assessment report:

sca-unit first.json second.json

Run a short validation check without printing the full JSON report:

sca-unit first.json second.json --check

When input JSON is invalid, SCA-Unit prints an input error plus a short expected-format hint.
