jnkn 0.0.0rc5

The Pre-Flight Impact Analysis Engine for Engineering Teams.

jnkn

The Pre-Flight Impact Analysis Engine for Engineering Teams.

jnkn (pronounced "jun-kan") prevents production outages by stitching together the hidden dependencies between your Infrastructure (Terraform), Data Pipelines (dbt), and Application Code (Python/JS).

---

📚 Read the Full Documentation

---

The Blind Spot

Most tools operate in silos. Terraform sees resources, dbt sees tables, code sees imports. jnkn sees the glue.

It detects the invisible, cross-domain breaking changes that slip through every other tool:

graph LR
    subgraph "The Gap"
        TF[Terraform Change] --"Breaks"--> CODE[App Configuration]
        CODE --"Breaks"--> DATA[Data Pipeline]
    end
    
    style TF fill:#ff6b6b,color:#fff
    style DATA fill:#ff6b6b,color:#fff

🚀 Quick Start

Get running in less than 2 minutes.

1. Installation

pip install jnkn

2. Initialize & Scan

Navigate to your project root (monorepo or service).

# Detects your stack (Python, Terraform, etc.)
jnkn init

# Builds the dependency graph
jnkn scan

3. Find Impact

Simulate a change to see what breaks downstream.

# If I rename this env var, what code breaks?
jnkn blast env:DATABASE_URL

# If I modify this Terraform resource, what app fails?
jnkn blast infra:payment_db_host

---

🤖 CI/CD Integration

Block breaking changes in Pull Requests before they merge.

# .github/workflows/jnkn.yml
steps:
  - uses: actions/checkout@v4
  - name: Run Jnkan Gate
    run: |
      pip install jnkn
      # Blocks if critical dependencies are broken
      jnkn check --git-diff origin/main HEAD

---

Supported Stacks

Domain	Supported Patterns
Python	os.getenv, Pydantic Settings, Click/Typer, django-environ
Terraform	Resources, variables, outputs, data sources
Kubernetes	ConfigMaps, Secrets, environment variables
dbt	ref(), source(), manifest parsing
JavaScript	process.env, dotenv, Vite

---

Contributing

We welcome contributions! Please see our Contributing Guide for details on how to set up your development environment.

License

MIT