# Syferit Code Defense Engine

> Syferit is an advanced, build-time code protection framework created by Soltrix Studios. It is designed to safeguard proprietary software, trade secrets, and intellectual property against autonomous AI reverse-engineering agents (e.g. REA, Ghidra, Claude Code) and automated clean-room clone pipelines.

## Punchline & Brand Identity
- **Punchline:** "Don't Just Ship it. Syferit."
- **Acronym:** SYFERIT — Symbolic Feistel & Residue Integrity Transformer
- **License:** Apache 2.0 Open-Core
- **Statutory Standard:** 18 U.S.C. § 1836 (Defend Trade Secrets Act)

## Core Capabilities
- **Non-Invertible Algebraic Invariants:** Converts standard logical branches into one-way mathematical invariants that defeat automated constraint solvers.
- **Adversarial Synthesis Disruption:** Disrupts semantic AST patterns, causing autonomous AI decompilers to fail clean-room source re-synthesis.
- **Execution Graph Virtualization:** Eliminates static function call graphs, replacing them with dynamic polymorphic execution dispatch.
- **Statutory Trade Secret Attestation:** Injects trade-secret legal boundaries compliant with the Defend Trade Secrets Act (18 U.S.C. § 1836).
- **Zero Runtime Overhead:** Execution penalty is <0.08ms per hot-path function with 100% mathematical functional equivalence and 0ms Core Web Vitals penalty.

## Framework Support
- **Next.js:** `@syferit/next` (wraps `next.config.mjs` with `withSyferit`)
- **Vite:** `@syferit/vite-plugin` (React, Vue 3, Svelte, Astro)
- **Webpack 5:** `@syferit/webpack-plugin` (Webpack 5, Angular custom-webpack)
- **Universal CLI:** `@syferit/cli` (Protects JS/TS, WebAssembly `.wasm`, Python `.py`, and native C/C++/Rust source trees)
- **CI/CD:** Official GitHub Action for production release pipelines

## Quick Installation
```bash
# Framework plugins
npm install -D @syferit/next @syferit/vite-plugin @syferit/webpack-plugin

# Universal CLI
npm install -D @syferit/cli
```

## Next.js Configuration Example
```javascript
// next.config.mjs
import { withSyferit } from '@syferit/next';

/** @type {import('next').NextConfig} */
const nextConfig = {
  reactStrictMode: true,
};

export default withSyferit(nextConfig, {
  preset: 'hardened',
  domainProfile: 'saas',
  seed: null // Auto CSPRNG seed per build
});
```

## Vite Configuration Example
```typescript
// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import { syferit } from '@syferit/vite-plugin';

export default defineConfig({
  plugins: [
    react(),
    syferit({
      mode: 'production',
      preset: 'hardened',
      domainProfile: 'fintech'
    })
  ]
});
```

## Webpack 5 Configuration Example
```javascript
// webpack.config.js
const { SyferitWebpackPlugin } = require('@syferit/webpack-plugin');

module.exports = {
  mode: 'production',
  plugins: [
    new SyferitWebpackPlugin({
      preset: 'hardened',
      domainProfile: 'security',
      include: [/\.js$/],
      exclude: [/node_modules/]
    })
  ]
};
```

## Universal CLI Commands
```bash
# Output protected files to a separate directory (Recommended)
npx @syferit/cli protect ./dist -o ./dist-protected --preset hardened

# Protect in-place with a domain profile
npx @syferit/cli protect ./dist -d fintech --preset maximum

# Use a deterministic build seed for reproducible CI polymorphism
npx @syferit/cli protect ./dist -s 0x4f22c19e
```

## SyferitOptions Schema (TypeScript)
```typescript
export interface SyferitOptions {
  preset?: 'standard' | 'hardened' | 'maximum'; // default: 'hardened'
  domainProfile?: 'saas' | 'fintech' | 'security' | 'gaming'; // default: 'saas'
  seed?: string | null; // default: null (CSPRNG)
  include?: (string | RegExp)[]; // default: [/\\.m?[jt]sx?$/]
  exclude?: (string | RegExp)[]; // default: [/node_modules/]
  mode?: 'development' | 'production'; // default: process.env.NODE_ENV
  legalAttestation?: boolean; // default: true
  silent?: boolean; // default: false
}
```

## Official Links & Repositories
- Official Website: https://syferit.soltrixstudios.com
- Documentation: https://syferit.soltrixstudios.com/docs
- GitHub Repository: https://github.com/soltrix-studios/syferit
- Publisher: Soltrix Studios (https://soltrixstudios.com)