ArcaneTech/Eridas — specification

Eridas

Deterministic self-healing software.

AppSec, OpSec, and cyber supply-chain security that does not invent findings. Eridas inventories exact npm lockfile versions, matches them to disclosed OSV advisories, scans what a live app actually leaks, and ships the smallest verified fix as a pull request — or it changes nothing.

Read-only until you opt into a PR. Scripts off during lockfile apply. Fail closed on stale lockfiles and unknown package managers. Optional AI explains confirmed findings only.

AppSec

Close disclosed dependency risk. The lockfile is inventory; OSV is the only advisory truth. AI may narrate a confirmed hit — it cannot invent a CVE or pick a version.

  • Exact installed versions, direct and transitive. npm package-lock.json v2/v3. pnpm and Yarn are refused, never silently approximated.
  • Smallest safe bump. Majors blocked unless you pass --allow-major.
  • Lifecycle scripts disabled while the lockfile regenerates. Manifest and lockfile restore together if verification fails.
  • fix prints a plan first. Non-interactive sessions cannot mutate without --yes or --force. --force skips the prompt only — not major policy, ignore-scripts, OSV rescan, or rollback.

OpSec

See what the live product leaks. Tinfoil is a passive, GET-only recon of the running app. Four cumulative levels, one graded report. Private, loopback, and metadata addresses are refused.

  • L1 Surface — headers, CSP, CORS, AI crawlers, llms.txt.
  • L2 Exposure (default) — .env, .git, source maps, secrets in bundles.
  • L3 Supply chain — OSV on announced packages or a lockfile.
  • L4 Reconstruction — what an attacker’s agent can rebuild (local only).

Open-source CLI

The eridas package needs no account. Scan, plan a fix, scaffold CI, run Tinfoil. Same contracts as Cloud: stable JSON, exit codes, dry-run.

GitHub App

Install the GitHub App, sync repos, and open deterministic fix PRs in an isolated worktree. Lifecycle: queued → running → open → merged. Never a silent push to default.

API, SDK, and MCP

Headless /api/v1, @eridas/cloud-sdk, @eridas/mcp, and a portable SKILL.md. Humans, CI, SOAR, and coding agents share one contract.

eridas · AppSec + OpSec

npx eridas scan .
npx eridas fix . --dry-run
npx eridas init . --mode fix
npx eridas tinfoil https://example.com --level 2
npx eridas scan . --ai --format json

eridas auth login
eridas cloud repos
eridas cloud scan --repo-id <uuid> --wait

import { EridasCloudClient } from "@eridas/cloud-sdk"

Scan in under a minute

No account for the CLI. Connect GitHub for Cloud. AppSec on the lockfile, OpSec on the live app. Deterministic results for humans, CI, and coding agents.