Skip to content

Commit 13177a7

Browse files
author
Jonathan D.A. Jewell
committed
Initial setup: Developer Ecosystem hub
Structure: - satellites/git-tools/ (gitvisor, gitloom, git-reunify, git-seo, polysafe-gitfixer, vext) - satellites/repo-management/ (oikos, robot-repo-automaton, grim-repo, robot-vacuum-cleaner) - satellites/scaffolding/ (scaffoldia) - satellites/developer-ux/ (rescript-evangeliser, recon-silly-ation, nickel-config-reporter) Central hub for all development workflow tools.
0 parents  commit 13177a7

17 files changed

Lines changed: 307 additions & 0 deletions

File tree

.claude/CLAUDE.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# CLAUDE.md - AI Assistant Instructions
2+
3+
## Language Policy (Hyperpolymath Standard)
4+
5+
### ALLOWED Languages & Tools
6+
7+
| Language/Tool | Use Case | Notes |
8+
|---------------|----------|-------|
9+
| **ReScript** | Primary application code | Compiles to JS, type-safe |
10+
| **Deno** | Runtime & package management | Replaces Node/npm/bun |
11+
| **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools |
12+
| **Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI |
13+
| **Dioxus** | Mobile apps (native UI) | Pure Rust, React-like |
14+
| **Gleam** | Backend services | Runs on BEAM or compiles to JS |
15+
| **Bash/POSIX Shell** | Scripts, automation | Keep minimal |
16+
| **JavaScript** | Only where ReScript cannot | MCP protocol glue, Deno APIs |
17+
| **Python** | SaltStack only | No other Python permitted |
18+
| **Nickel** | Configuration language | For complex configs |
19+
| **Guile Scheme** | State/meta files | STATE.scm, META.scm, ECOSYSTEM.scm |
20+
| **Julia** | Batch scripts, data processing | Per RSR |
21+
| **OCaml** | AffineScript compiler | Language-specific |
22+
| **Ada** | Safety-critical systems | Where required |
23+
24+
### BANNED - Do Not Use
25+
26+
| Banned | Replacement |
27+
|--------|-------------|
28+
| TypeScript | ReScript |
29+
| Node.js | Deno |
30+
| npm | Deno |
31+
| Bun | Deno |
32+
| pnpm/yarn | Deno |
33+
| Go | Rust |
34+
| Python (general) | ReScript/Rust |
35+
| Java/Kotlin | Rust/Tauri/Dioxus |
36+
| Swift | Tauri/Dioxus |
37+
| React Native | Tauri/Dioxus |
38+
| Flutter/Dart | Tauri/Dioxus |
39+
40+
### Developer Ecosystem Specific
41+
42+
For developer tools:
43+
- **Rust** preferred for CLI tools, git operations
44+
- **ReScript** for web dashboards (gitvisor)
45+
- **Deno** for automation scripts
46+
- **Julia** for batch analysis (oikos metrics)
47+
48+
### Security Requirements
49+
50+
- No MD5/SHA1 for security (use SHA256+)
51+
- HTTPS only (no HTTP URLs)
52+
- No hardcoded secrets
53+
- SHA-pinned dependencies
54+
- SPDX license headers on all files

.gitmodules

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
[submodule "satellites/git-tools/gitvisor"]
2+
path = satellites/git-tools/gitvisor
3+
url = git@github.com:hyperpolymath/gitvisor.git
4+
[submodule "satellites/git-tools/gitloom"]
5+
path = satellites/git-tools/gitloom
6+
url = git@github.com:hyperpolymath/gitloom.git
7+
[submodule "satellites/git-tools/git-reunify"]
8+
path = satellites/git-tools/git-reunify
9+
url = git@github.com:hyperpolymath/git-reunify.git
10+
[submodule "satellites/git-tools/git-seo"]
11+
path = satellites/git-tools/git-seo
12+
url = git@github.com:hyperpolymath/git-seo.git
13+
[submodule "satellites/git-tools/polysafe-gitfixer"]
14+
path = satellites/git-tools/polysafe-gitfixer
15+
url = git@github.com:hyperpolymath/polysafe-gitfixer.git
16+
[submodule "satellites/git-tools/vext"]
17+
path = satellites/git-tools/vext
18+
url = git@github.com:hyperpolymath/vext.git
19+
[submodule "satellites/repo-management/oikos"]
20+
path = satellites/repo-management/oikos
21+
url = git@github.com:hyperpolymath/oikos.git
22+
[submodule "satellites/repo-management/robot-repo-automaton"]
23+
path = satellites/repo-management/robot-repo-automaton
24+
url = git@github.com:hyperpolymath/robot-repo-automaton.git
25+
[submodule "satellites/repo-management/grim-repo"]
26+
path = satellites/repo-management/grim-repo
27+
url = git@github.com:hyperpolymath/grim-repo.git
28+
[submodule "satellites/repo-management/robot-vacuum-cleaner"]
29+
path = satellites/repo-management/robot-vacuum-cleaner
30+
url = git@github.com:hyperpolymath/robot-vacuum-cleaner.git
31+
[submodule "satellites/scaffolding/scaffoldia"]
32+
path = satellites/scaffolding/scaffoldia
33+
url = git@github.com:hyperpolymath/scaffoldia.git
34+
[submodule "satellites/developer-ux/rescript-evangeliser"]
35+
path = satellites/developer-ux/rescript-evangeliser
36+
url = git@github.com:hyperpolymath/rescript-evangeliser.git
37+
[submodule "satellites/developer-ux/recon-silly-ation"]
38+
path = satellites/developer-ux/recon-silly-ation
39+
url = git@github.com:hyperpolymath/recon-silly-ation.git
40+
[submodule "satellites/developer-ux/nickel-config-reporter"]
41+
path = satellites/developer-ux/nickel-config-reporter
42+
url = git@github.com:hyperpolymath/nickel-config-reporter.git

README.adoc

Lines changed: 197 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,197 @@
1+
// SPDX-License-Identifier: MIT AND Palimpsest-0.8
2+
// SPDX-FileCopyrightText: 2024-2025 hyperpolymath
3+
4+
= Developer Ecosystem
5+
:author: hyperpolymath
6+
:revnumber: 0.1.0
7+
:revdate: 2025-12-26
8+
:toc: left
9+
:toclevels: 3
10+
:icons: font
11+
:source-highlighter: rouge
12+
13+
image:https://img.shields.io/badge/RSR-Gold-ffd700[RSR Gold]
14+
image:https://img.shields.io/badge/CCCP-Certified-c41e3a[CCCP Certified]
15+
16+
== What is Developer Ecosystem?
17+
18+
*Developer Ecosystem* is the central hub for all development workflow tools—git operations, repository management, scaffolding, and developer experience.
19+
20+
This primary brings together projects that improve how developers:
21+
22+
* *Git Tools* — Forge management, branch workflows, repo unification
23+
* *Repo Management* — Automation, analysis, health monitoring
24+
* *Scaffolding* — Project templates, boilerplate generation
25+
* *Developer UX* — IDE extensions, documentation tools, reconciliation
26+
27+
== Satellite Structure
28+
29+
[source]
30+
----
31+
developer-ecosystem/
32+
├── satellites/
33+
│ ├── git-tools/ # Git forge & workflow tools
34+
│ │ ├── gitvisor/ # Unified git platform dashboard
35+
│ │ ├── gitloom/ # Branch management & weaving
36+
│ │ ├── git-reunify/ # Safe repo reunification
37+
│ │ ├── git-seo/ # Git repo discoverability
38+
│ │ ├── polysafe-gitfixer/ # Git backup merger
39+
│ │ └── vext/ # IRC commit notifications
40+
│ │
41+
│ ├── repo-management/ # Repository automation & analysis
42+
│ │ ├── oikos/ # Ecological code analysis
43+
│ │ ├── robot-repo-automaton/ # Automated repo management
44+
│ │ ├── grim-repo/ # Audit-grade repo tooling
45+
│ │ └── robot-vacuum-cleaner/ # Repo tidying bot
46+
│ │
47+
│ ├── scaffolding/ # Project generation
48+
│ │ └── scaffoldia/ # Community-driven scaffolding
49+
│ │
50+
│ └── developer-ux/ # Developer experience tools
51+
│ ├── rescript-evangeliser/ # ReScript teaching extension
52+
│ ├── recon-silly-ation/ # Doc reconciliation system
53+
│ └── nickel-config-reporter/ # Config auditing
54+
----
55+
56+
== Git Tools
57+
58+
Repositories focused on Git operations across multiple forges (GitHub, GitLab, Gitea, Bitbucket).
59+
60+
=== gitvisor
61+
62+
A hyper-customizable dashboard for unified Git platform management.
63+
Starting with GitHub and GitLab integration, expanding to become the definitive interface for developers who demand control.
64+
65+
=== gitloom
66+
67+
Git workflow weaving and branch management.
68+
Advanced branch operations with safety guarantees.
69+
70+
=== git-reunify
71+
72+
Safe repo reunification tool—merge diverged repos without losing work.
73+
Handles developer reconciliation scenarios where repos have drifted apart.
74+
75+
=== git-seo
76+
77+
Make your Git repositories discoverable with SEO optimization tools.
78+
Metadata, descriptions, and tagging for better findability.
79+
80+
=== polysafe-gitfixer
81+
82+
A polyglot implementation of a git backup merger tool.
83+
Each component written in the language providing the strongest safety guarantees for that concern.
84+
85+
=== vext
86+
87+
High-performance IRC notification daemon for version control systems.
88+
Real-time commit notifications from Git repos to IRC channels with connection pooling.
89+
90+
== Repo Management
91+
92+
Repositories focused on automated repository analysis, health monitoring, and maintenance.
93+
94+
=== oikos
95+
96+
*Ecological & Economic Code Analysis Platform*
97+
98+
_οἶκος_ (oikos): the shared Greek root of ecology and economy.
99+
100+
Features:
101+
* Carbon intensity scoring
102+
* Sustainability metrics
103+
* Pareto-optimal code health
104+
* GitHub/GitLab integration
105+
106+
=== robot-repo-automaton
107+
108+
Automated repository management bot.
109+
Handles routine maintenance, updates, and health checks.
110+
111+
=== grim-repo
112+
113+
Modular audit-grade tooling for narratable, scaffolded, and legible repositories.
114+
Ensures repos meet quality and documentation standards.
115+
116+
=== robot-vacuum-cleaner
117+
118+
A comprehensive, production-grade robot vacuum cleaner simulation system.
119+
Includes repository tidying capabilities.
120+
121+
== Scaffolding
122+
123+
Repositories focused on project template generation and structure.
124+
125+
=== scaffoldia
126+
127+
A developer-centred, modular, and community-driven repo scaffolding engine.
128+
129+
* Generates idiomatic, validated, narratable project structures
130+
* Supports multiple languages, tools, and themes
131+
* Audience-aware stance configuration
132+
133+
== Developer UX
134+
135+
Repositories focused on improving the developer experience.
136+
137+
=== rescript-evangeliser
138+
139+
"Celebrate good, minimize bad, show better"
140+
141+
A VS Code extension that teaches JavaScript developers ReScript through progressive code transformation, without shame.
142+
143+
=== recon-silly-ation
144+
145+
Documentation Reconciliation System.
146+
147+
Automatically reconcile, deduplicate, and resolve conflicts in Git repository documentation using:
148+
* Content-addressable storage
149+
* Graph-based conflict resolution
150+
151+
=== nickel-config-reporter
152+
153+
Ingests config files, clones to Nickel format, emits AsciiDoc audit reports.
154+
155+
== Relationship to Other Primaries
156+
157+
[cols="1,2"]
158+
|===
159+
| Primary | Relationship
160+
161+
| *rhodium-standard-repositories*
162+
| RSR compliance standards for developer-ecosystem satellites
163+
164+
| *poly-mcps*
165+
| poly-git-mcp uses developer-ecosystem git tools
166+
167+
| *neural-foundations*
168+
| oikos uses AI for code analysis (neurosymbolic potential)
169+
170+
| *cccp*
171+
| Language policy governs all implementations
172+
|===
173+
174+
== Notable Standalone Projects
175+
176+
Some developer tools remain standalone due to their unique nature:
177+
178+
* *valence-shell* — Reversible thermodynamic shell (fundamental paradigm shift)
179+
* *cicd-hyper-a* — Reusable CI/CD templates (infrastructure, not tooling)
180+
181+
== Contributing
182+
183+
Contributions should focus on *developer workflow improvements*:
184+
185+
1. Git forge integrations
186+
2. Repository analysis algorithms
187+
3. Scaffolding templates
188+
4. Developer experience enhancements
189+
190+
== License
191+
192+
MIT + Palimpsest-0.8
193+
194+
---
195+
196+
_"Developer tools that respect developer autonomy. No lock-in, no shame, no anxiety."_
197+
Submodule nickel-config-reporter added at 4d5f6d6
Submodule recon-silly-ation added at 3c475a9
Submodule rescript-evangeliser added at 33c29fc

satellites/git-tools/git-reunify

Submodule git-reunify added at fdbbbe8

satellites/git-tools/git-seo

Submodule git-seo added at 955aa07

satellites/git-tools/gitloom

Submodule gitloom added at 90e0f4a

satellites/git-tools/gitvisor

Submodule gitvisor added at d992a8f

0 commit comments

Comments
 (0)