From da793733cdee9c73004a48adea1a011abddff296 Mon Sep 17 00:00:00 2001 From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com> Date: Mon, 29 Jun 2026 14:17:46 +0100 Subject: [PATCH] revert(readme): restore canonical README.adoc; remove runaway .md conversion AsciiDoc is canonical here; the estate-wide 'convert -> Markdown' pass over-applied the narrow boj-server/hyperpolymath .md rule. Restore README.adoc, remove README.md. Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 214 ------------------------------------------------------ 1 file changed, 214 deletions(-) delete mode 100644 README.md diff --git a/README.md b/README.md deleted file mode 100644 index a00256abc..000000000 --- a/README.md +++ /dev/null @@ -1,214 +0,0 @@ -[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github)](https://github.com/sponsors/hyperpolymath) - -image:https://img.shields.io/badge/License-MPL_2.0-blue.svg[MPL-2.0-or-later,link="https://opensource.org/licenses/MPL-2.0"] -image:https://img.shields.io/badge/Philosophy-Palimpsest-indigo.svg[Palimpsest,link="https://github.com/hyperpolymath/palimpsest-license"] - - -// SPDX-License-Identifier: CC-BY-SA-4.0 -// SPDX-FileCopyrightText: 2024-2025 hyperpolymath - -= Developer Ecosystem - -:author: hyperpolymath -:revnumber: 0.1.0 -:revdate: 2025-12-26 -:toc: left -:toclevels: 3 -:icons: font -:source-highlighter: rouge - -image:https://img.shields.io/badge/RSR-Gold-ffd700[RSR Gold] -image:https://img.shields.io/badge/CCCP-Certified-c41e3a[CCCP Certified] - -== License & Philosophy - -This project must declare **MPL-2.0-or-later** for platform/tooling compatibility. - -Philosophy: **Palimpsest**. The Palimpsest-MPL (PMPL) text is provided in `license/PMPL-1.0.txt`, and the canonical source is the palimpsest-license repository. - -== What is Developer Ecosystem? - -*Developer Ecosystem* is the central hub for all development workflow tools—git operations, repository management, scaffolding, and developer experience. - -This primary brings together projects that improve how developers: - -* *Git Tools* — Forge management, branch workflows, repo unification -* *Repo Management* — Automation, analysis, health monitoring -* *Scaffolding* — Project templates, boilerplate generation -* *Developer UX* — IDE extensions, documentation tools, reconciliation - -== Satellite Structure - -[source] ----- -developer-ecosystem/ -├── satellites/ -│ ├── git-tools/ # Git forge & workflow tools -│ │ ├── git-hud/ # Unified git platform dashboard -│ │ ├── gitloom/ # Branch management & weaving -│ │ ├── git-reunify/ # Safe repo reunification -│ │ ├── git-seo/ # Git repo discoverability -│ │ ├── polysafe-gitfixer/ # Git backup merger -│ │ └── vext/ # IRC commit notifications -│ │ -│ ├── repo-management/ # Repository automation & analysis -│ │ ├── oikos/ # Ecological code analysis -│ │ ├── robot-repo-automaton/ # Automated repo management -│ │ ├── grim-repo/ # Audit-grade repo tooling -│ │ └── robot-vacuum-cleaner/ # Repo tidying bot -│ │ -│ ├── scaffolding/ # Project generation -│ │ └── scaffoldia/ # Community-driven scaffolding -│ │ -│ └── developer-ux/ # Developer experience tools -│ ├── rescript-evangeliser/ # ReScript teaching extension -│ ├── recon-silly-ation/ # Doc reconciliation system -│ └── nickel-config-reporter/ # Config auditing ----- - -== Git Tools - -Repositories focused on Git operations across multiple forges (GitHub, GitLab, Gitea, Bitbucket). - -=== git-hud - -A hyper-customizable dashboard for unified Git platform management. -Starting with GitHub and GitLab integration, expanding to become the definitive interface for developers who demand control. - -=== gitloom - -Git workflow weaving and branch management. -Advanced branch operations with safety guarantees. - -=== git-reunify - -Safe repo reunification tool—merge diverged repos without losing work. -Handles developer reconciliation scenarios where repos have drifted apart. - -=== git-seo - -Make your Git repositories discoverable with SEO optimization tools. -Metadata, descriptions, and tagging for better findability. - -=== polysafe-gitfixer - -A polyglot implementation of a git backup merger tool. -Each component written in the language providing the strongest safety guarantees for that concern. - -=== vext - -High-performance IRC notification daemon for version control systems. -Real-time commit notifications from Git repos to IRC channels with connection pooling. - -== Repo Management - -Repositories focused on automated repository analysis, health monitoring, and maintenance. - -=== oikos - -*Ecological & Economic Code Analysis Platform* - -_οἶκος_ (oikos): the shared Greek root of ecology and economy. - -Features: -* Carbon intensity scoring -* Sustainability metrics -* Pareto-optimal code health -* GitHub/GitLab integration - -=== robot-repo-automaton - -Automated repository management bot. -Handles routine maintenance, updates, and health checks. - -=== grim-repo - -Modular audit-grade tooling for narratable, scaffolded, and legible repositories. -Ensures repos meet quality and documentation standards. - -=== robot-vacuum-cleaner - -A comprehensive, production-grade robot vacuum cleaner simulation system. -Includes repository tidying capabilities. - -== Scaffolding - -Repositories focused on project template generation and structure. - -=== scaffoldia - -A developer-centred, modular, and community-driven repo scaffolding engine. - -* Generates idiomatic, validated, narratable project structures -* Supports multiple languages, tools, and themes -* Audience-aware stance configuration - -== Developer UX - -Repositories focused on improving the developer experience. - -=== rescript-evangeliser - -"Celebrate good, minimize bad, show better" - -A VS Code extension that teaches JavaScript developers ReScript through progressive code transformation, without shame. - -=== recon-silly-ation - -Documentation Reconciliation System. - -Automatically reconcile, deduplicate, and resolve conflicts in Git repository documentation using: -* Content-addressable storage -* Graph-based conflict resolution - -=== nickel-config-reporter - -Ingests config files, clones to Nickel format, emits AsciiDoc audit reports. - -== Relationship to Other Primaries - -[cols="1,2"] -|=== -| Primary | Relationship - -| *rhodium-standard-repositories* -| RSR compliance standards for developer-ecosystem satellites - -| *poly-mcps* -| poly-git-mcp uses developer-ecosystem git tools - -| *neural-foundations* -| oikos uses AI for code analysis (neurosymbolic potential) - -| *cccp* -| Language policy governs all implementations -|=== - -== Notable Standalone Projects - -Some developer tools remain standalone due to their unique nature: - -* *valence-shell* — Reversible thermodynamic shell (fundamental paradigm shift) -* *cicd-hyper-a* — Reusable CI/CD templates (infrastructure, not tooling) - -== Contributing - -Contributions should focus on *developer workflow improvements*: - -1. Git forge integrations -2. Repository analysis algorithms -3. Scaffolding templates -4. Developer experience enhancements - -== License - -MIT + Palimpsest-0.8 - ---- - -_"Developer tools that respect developer autonomy. No lock-in, no shame, no anxiety."_ - - -== Architecture - -See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.