Skip to content

hyperpolymath/asdf-control-tower

License: PMPL-1.0 Palimpsest

asdf-control-tower

Central hub for the hyperpolymath asdf plugin ecosystem - providing multi-forge mirroring infrastructure, coordination, and documentation for a planned collection of asdf version manager plugins.

Project Status

Component Status

Multi-forge mirroring

✓ Implemented

Instant-sync dispatch

✓ Implemented

Static documentation site

✓ Implemented

asdf plugins

Specification only (none released)

What’s Here

Implemented Infrastructure

This repository contains working CI/CD infrastructure:

File Purpose

.github/workflows/mirror.yml

Hub-and-spoke mirroring to GitLab, Codeberg, Bitbucket

.github/workflows/instant-sync.yml

Event-driven propagation via repository dispatch

.github/workflows/pages.yml

Static site build and deployment (terrapin-ssg + Asciidoctor)

Documentation Site Content

Located in site/content/:

  • index.adoc - Ecosystem overview and philosophy

  • plugins.adoc - Planned plugin specifications

  • infrastructure.adoc - Architecture and security documentation

  • roadmap.adoc - Development phases and milestones

Configuration

  • .claude/CLAUDE.md - Hyperpolymath Language Policy (tech stack standards)

Architecture

                    ┌─────────────┐
                    │   GitHub    │
                    │   (Hub)     │
                    └──────┬──────┘
                           │
           ┌───────────────┼───────────────┐
           │               │               │
           ▼               ▼               ▼
    ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
    │   GitLab    │ │  Codeberg   │ │  Bitbucket  │
    │   (Spoke)   │ │   (Spoke)   │ │   (Spoke)   │
    └─────────────┘ └─────────────┘ └─────────────┘

Planned Plugins

Target cloud-native tooling:

Plugin Category Status

asdf-k9s

Kubernetes

Planned

asdf-yq

YAML processing

Planned

asdf-trivy

Security scanning

Planned

asdf-hadolint

Dockerfile linting

Planned

asdf-buf

Protobuf tooling

Planned

asdf-grype

Vulnerability scanning

Planned

asdf-earthly

Build automation

Planned

asdf-dagger

CI/CD

Planned

asdf-helmfile

Kubernetes/Helm

Planned

asdf-kustomize

Kubernetes

Planned

Security Measures

  • SSH known hosts verification (MITM prevention)

  • SHA-pinned GitHub Actions (supply chain security)

  • Minimal workflow permissions (read-all)

  • No credential persistence

  • Job timeouts and concurrency controls

Installation (Future)

Once plugins are released:

asdf plugin add <plugin-name> https://github.com/hyperpolymath/asdf-<plugin-name>.git
asdf install <plugin-name> latest

License

MPL-2.0 (see LICENSE and PALIMPSEST.adoc)

About

Central control for asdf plugin management

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 3

  •  
  •  
  •