ASA CLI — Architecture Stabilization Engine
Scan. Stabilize. Verify. Ship with confidence.
Detect structural chaos in AI-built apps. Stabilize architecture without rewriting. Install production-ready foundations. Verify compliance before every deploy.
Install
pip install asa-standard
The CLI command is
asa(notasa-standard). Requires Python 3.10+.
Quick Start
# Diagnose structural risk (always free)
asa scan .
# Stabilize an existing app (hero command)
asa stabilize --yes
# Or step by step:
asa spec infer . # Infer architecture spec
asa plan # Dry-run — see what changes
asa apply # Install foundation
asa verify # Check architecture compliance
asa repair # Fix remaining drift
Commands
Diagnostic (Always Free)
| Command | Description |
|---|---|
asa scan [path] |
AI Chaos Index — structural risk score (0–100), 5 root causes, risk band |
asa scan [path] --json |
Machine-readable JSON output for CI pipelines |
Stabilization Engine
| Command | Description |
|---|---|
asa stabilize [--yes] [--dry-run] |
Full flow: scan → infer → plan → apply → bridge → verify |
asa spec infer [path] |
Infer .asa/spec.yaml from existing codebase |
asa plan |
Dry-run — show what asa apply would do |
asa apply |
Install foundation architecture from spec |
asa verify [--ci] |
Verify architecture vs .asa/spec.yaml (CI-ready) |
asa repair [--auto] |
Detect drift and suggest/apply fixes |
Foundation
| Command | Description |
|---|---|
asa init --name <name> |
Initialize new ASA project (Next.js App Router starter) |
asa install <module> |
Install foundation module (see below) |
asa lint [--strict] |
Boundary + contract + security + entitlement enforcement |
asa deploy [--check | --staging | --prod] |
Architecture-safe deployment (Vercel + Supabase) |
Slice Management
| Command | Description |
|---|---|
asa slice new <domain/name> |
Create vertical slice (handler + schemas + UI + contract) |
asa slice update <domain/name> |
Regenerate after spec change (preserves user code) |
asa slice plan <spec> |
Propose slice architecture from functional spec |
asa slice split <name> |
Analyze oversized slice, propose split |
asa slice build <name> |
Internal build pipeline (contract → zod → skeleton) |
asa slice sync |
Validate all contracts across project |
asa slice analyze <name> |
Detailed slice analysis (LOC, imports, coupling) |
UI Generation
| Command | Description |
|---|---|
asa ui generate <name> |
Regenerate frontend part of slice from contract |
Foundation Modules
| Module | What it creates |
|---|---|
db-basic |
Supabase client (browser/server/admin), types, utils, seed, migrations framework |
auth-basic |
Login, register, logout, reset-password slices + middleware, session, guards, hooks, RLS policies |
payments-basic |
Subscribe, cancel, webhook (inbox pattern), check-limits slices + Stripe config, entitlements, reconciliation |
admin-basic |
Dashboard, users, roles, impersonation, audit-log slices + RBAC guards, immutable audit trail |
How It Works
Your code never leaves your machine. The CLI runs locally, offline, using static analysis.
- Scan — Measure structural risk with the AI Chaos Index (0–100)
- Stabilize — Add architecture to existing apps without rewriting
- Build — Create new features as isolated vertical slices
- Verify — Check compliance before every deploy
Links
- ASA Standard: asastandard.org — open architecture specification
- Website: vibecodiq.com
- CLI docs: vibecodiq.com/scan/cli
- GitHub: janvoldan/asa-cli
v2.1.0 — 2026-03-11
1 maintainer
Metadata
1 maintainer
Release files for asa-standard 2.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| asa_standard-2.1.1.tar.gz | 57.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| asa_standard-2.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 158.9 kB
Release files / asa_standard-2.1.1.tar.gz
| Download URL | asa_standard-2.1.1.tar.gz |
|---|---|
| Size | 57.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
61423d286de91909019b634ba5736f36d47684b9a4f80154a2685f6736295140
|
|
BLAKE2b-256 checksum How to use checksums |
2ba9607e7da67219a0efbdb722c9165c6eaf58621724a66ceea20c48449056a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Release files / asa_standard-2.1.1-py3-none-any.whl
| Download URL | asa_standard-2.1.1-py3-none-any.whl |
|---|---|
| Size | 101.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
817f061dd06ff25423817d31657c227aaf97fd3dc6b020b01c31f5d9a765d56d
|
|
BLAKE2b-256 checksum How to use checksums |
1bbbcf51254cfb088f669b1b7dcdb0452f9a95b1d1c7542730b6145debe49b91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Security for asa-standard 2.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
