📐 Studio Architecture Specification

Crystal Studio Labs follows strict architectural guidelines to ensure high-performance execution, zero secret exposure, and lightweight tool footprints across all repositories.

Stack & Layering Declarations

Developer Tools & CI Actions: JavaScript (Node.js ESM), Shell (Bash / POSIX), Go, Rust.
Terminal Interfaces (TUI): gum framework, Charm ecosystem, POSIX terminal fallbacks.
Web Portals & Apps: Static HTML5, CSS Industrial Brutalism custom tokens, Vanilla JavaScript, Jekyll static hosting engine.

Source Repository: ARCHITECTURE.md [RAW_MD] ↗

🛡️ ARGUS Action Specification

ARGUS is an autonomous pull request reviewer that enforces compliance with zero-placeholder rules, architectural declarations, and generates topology flowcharts.

Governance Rules

ARGUS-01 (Zero-Placeholders): Blocks PRs containing hardcoded secrets or empty stubs.
ARGUS-02 (Spec-Compliance): Verifies stack alignment against architecture.md.
ARGUS-03 (Structural-Clarity): Renders interactive Mermaid.js impact diagrams in the PR review thread.

Example GitHub Workflow Integration

name: ARGUS PR Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Crystal-Studio-Labs/Argus@v1
        with:
          github_token: $

🛠️ MenuForge TUI Specification

MenuForge bridges terminal binaries, standalone scripts, and games into a structured desktop environment launcher using Charm's gum framework.

Core Capabilities

Custom category menus with search filtering.
Automated environment configuration & environment variable injection.
POSIX terminal auto-detection.

💻 CrystalSystem Telemetry Engine

Zero-dependency system resource monitor for Node.js environments. Provides both real-time TUI dashboard and lightweight REST endpoints.

API Endpoints

GET /api/v1/system   # Returns CPU, Memory, Disk, and Battery telemetry
GET /api/v1/health   # Returns 200 OK status check

🤝 Contribution Guidelines

We welcome contributions from developers worldwide! All contributions are subject to automated verification via ARGUS.

Branch Conventions

feat/feature-description
fix/bugfix-description
docs/documentation-update

📜 Code of Conduct

We pledge to foster an inclusive, harassment-free environment for all contributors. Respectful collaboration is required across all repositories and communication channels.

🛡️ Security Policy

Please report potential security vulnerabilities privately via security@crystalstudiolabs.com or private Discord message. Do not open public issues for security exploits.