Skip to content

Commit dc34d02

Browse files
hyperpolymathclaude
hyperpolymath
and
claude
committed
feat: Phase 0 — clade taxonomy, VeriSimDB schema, and 200-repo seed
Establishes the gv-clade-index as the central registry for the hyperpolymath ecosystem. Map and territory: VeriSimDB is the map, repos are the territory. - 12 clade definitions (fv/nl/rm/gv/db/ap/ix/dx/pt/ax/gm/sc) - 200 repos classified with primary + secondary clades - 7 VQL schemas: repo, clade, todo, observation, feedback, lineage, forge-identity - 8 pre-built queries: dashboard, stale, orphans, drift, bot-findings, blocked, cross-clade-deps, feedback-status - Pointer authority system (pointer/local/derived) - Forge PK/FK model (GitHub primary, GitLab/Bitbucket/Codeberg/SourceHut mirrors) - Clade-hygiene contractile (every repo MUST have CLADE.a2ml) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 828fa6b commit dc34d02

21 files changed

Lines changed: 640 additions & 355 deletions

‎.gitignore‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,3 +103,6 @@ sync_report*.txt
103103

104104
# Hypatia scan cache (local-only)
105105
.hypatia/
106+
107+
# Generated views (not committed)
108+
views/

‎.machine_readable/6a2/ECOSYSTEM.a2ml‎

Lines changed: 40 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,46 @@
11
# SPDX-License-Identifier: PMPL-1.0-or-later
2-
# Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
3-
#
4-
# ECOSYSTEM.a2ml — Project ecosystem position
5-
# Relationships, dependencies, integration points.
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
63

7-
[metadata]
8-
version = "0.1.0"
9-
last-updated = "{{CURRENT_DATE}}"
4+
[ecosystem]
5+
version = "1.0.0"
6+
name = "gv-clade-index"
7+
type = "registry"
8+
purpose = "Central taxonomy and registry for 200+ hyperpolymath repositories"
9+
position-in-ecosystem = "Core governance — single source of truth for repo identity, clades, work items, bot findings"
1010

11-
[project]
12-
name = "{{PROJECT_NAME}}"
13-
purpose = "{{PROJECT_PURPOSE}}"
14-
role = "{{PROJECT_ROLE}}" # e.g. ffi-infrastructure, cli-tool, library, service
11+
[related-projects]
1512

16-
[position-in-ecosystem]
17-
tier = "infrastructure" # 1 | 2 | infrastructure
13+
[related-projects.verisimdb]
14+
relationship = "depends-on"
15+
description = "Uses VeriSimDB as the database engine"
16+
repo = "nextgen-databases/verisimdb"
1817

19-
[related-projects]
20-
# relationship types: sibling-standard, dependency, dependent, inspiration, potential-consumer
21-
# - { name = "language-bridges", relationship = "sibling-standard" }
22-
# - { name = "hypatia", relationship = "potential-consumer" }
18+
[related-projects.hyperpolymath-github-io]
19+
relationship = "feeds-into"
20+
description = "Portal frontend queries this registry"
21+
repo = "hyperpolymath.github.io"
22+
23+
[related-projects.reposystem]
24+
relationship = "sibling"
25+
description = "Reposystem is graph engine; clade-index is identity registry"
26+
repo = "reposystem"
27+
28+
[related-projects.palimpsest-plasma]
29+
relationship = "sibling"
30+
description = "PMPL governance engine; consumes clade-index for compliance"
31+
repo = "palimpsest-plasma"
32+
33+
[related-projects.gitbot-fleet]
34+
relationship = "feeds-into"
35+
description = "Bots write observations to VeriSimDB"
36+
repo = "gitbot-fleet"
37+
38+
[related-projects.hypatia]
39+
relationship = "feeds-into"
40+
description = "Hypatia scan results feed observation octads"
41+
repo = "hypatia"
2342

24-
[integration-points]
25-
# External systems this project connects to
26-
# - { system = "gitbot-fleet", direction = "outbound", protocol = "repository_dispatch" }
43+
[related-projects.seamstress]
44+
relationship = "sibling"
45+
description = "Seam definitions validate cross-clade boundaries"
46+
repo = "seamstress"

‎.machine_readable/6a2/META.a2ml‎

Lines changed: 51 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,55 @@
11
# SPDX-License-Identifier: PMPL-1.0-or-later
2-
# Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
3-
#
4-
# META.a2ml — Project meta-level information
5-
# Architecture decisions, design rationale, governance.
6-
7-
[metadata]
8-
version = "0.1.0"
9-
last-updated = "{{CURRENT_DATE}}"
10-
11-
[project-info]
12-
type = "{{PROJECT_TYPE}}" # library | binary | monorepo | service | website
13-
languages = [] # e.g. ["rust", "zig", "idris2"]
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
4+
[project]
5+
name = "gv-clade-index"
6+
description = "VeriSimDB-backed clade taxonomy and central registry for the hyperpolymath ecosystem"
147
license = "PMPL-1.0-or-later"
15-
author = "{{AUTHOR}} ({{OWNER}})"
8+
standard = "RSR 2026"
9+
10+
[author]
11+
name = "Jonathan D.A. Jewell"
12+
email = "j.d.a.jewell@open.ac.uk"
13+
github = "hyperpolymath"
1614

1715
[architecture-decisions]
18-
# ADR format: status = proposed | accepted | deprecated | superseded | rejected
19-
# - { id = "ADR-001", title = "Use Zig for FFI", status = "accepted", date = "2026-02-14" }
20-
21-
[development-practices]
22-
build-tool = "just"
23-
container-runtime = "podman"
24-
ci-platform = "github-actions"
25-
package-manager = "guix" # guix | nix | cargo | mix
26-
27-
[maintenance-axes]
28-
scoping-first = true
29-
execution-order = "axis-1 > axis-2 > axis-3"
30-
axis-1 = "must > intend > like"
31-
axis-2 = "corrective > adaptive > perfective"
32-
axis-3 = "systems > compliance > effects"
33-
34-
[scoping]
35-
sources = "README, roadmap, status docs, maintenance checklist, CI/security docs"
36-
marker-scan = "TODO/FIXME/XXX/HACK/STUB/PARTIAL"
37-
idris-unsound-scan = "believe_me/assert_total"
38-
39-
[axis-2-maintenance-rules]
40-
corrective-first = true
41-
adaptive-second = true
42-
adaptive-focus = "scope-change reconciliation, stale-reference removal, obsolete-work culling"
43-
perfective-third = true
44-
perfective-source = "axis-1 honest state after corrective/adaptive updates"
45-
46-
[axis-3-audit-rules]
47-
audit-focus = "systems in place, documentation explains actual state, safety/security accounted for, observed effects reviewed"
48-
compliance-focus = "seams/compromises/exception register, bounded exceptions, anti-drift checks"
49-
drift-risk-example = "single exception broadening into policy violation (e.g. ReScript->TypeScript spread)"
50-
effects-evidence = "benchmark execution/results and maintainer status dialogue/review"
51-
52-
[design-rationale]
53-
# Key design decisions and their reasoning
16+
17+
[architecture-decisions.adr-001]
18+
title = "VeriSimDB as central registry"
19+
status = "accepted"
20+
date = "2026-03-16"
21+
context = "200+ repos with scattered state across memory files, STATE.a2ml, bot logs, queue dumps"
22+
decision = "Use VeriSimDB 8-modality octad model as single source of truth for ecosystem metadata"
23+
consequences = "All agents read/write to VeriSimDB instead of scattered files"
24+
25+
[architecture-decisions.adr-002]
26+
title = "Pointer authority system"
27+
status = "accepted"
28+
date = "2026-03-16"
29+
context = "Need to resolve data ownership between repos and central DB"
30+
decision = "Every datum has an authority pointer (pointer/local/derived) declaring canonical source"
31+
consequences = "Drift detection catches stale caches; no single-winner authority model needed"
32+
33+
[architecture-decisions.adr-003]
34+
title = "2-character clade prefix for repo names"
35+
status = "accepted"
36+
date = "2026-03-16"
37+
context = "Alphabetical repo listing is unstructured"
38+
decision = "12 two-character codes as name prefix for visual grouping"
39+
consequences = "Repos sort into clades when listed; Julia .jl packages exempt"
40+
41+
[architecture-decisions.adr-004]
42+
title = "ReScript/WASM public portal"
43+
status = "accepted"
44+
date = "2026-03-16"
45+
context = "Visitors need GitHub literacy to understand ecosystem"
46+
decision = "hyperpolymath.github.io becomes ReScript TEA + WASM app querying VeriSimDB"
47+
consequences = "Public discovery without repo access; LLM API for external agents"
48+
49+
[architecture-decisions.adr-005]
50+
title = "Map and territory separation"
51+
status = "accepted"
52+
date = "2026-03-16"
53+
context = "Need clean presentation while repos may be messy"
54+
decision = "VeriSimDB is the map (queryable, clean); repos are the territory"
55+
consequences = "Editing the map never damages the territory"

‎.machine_readable/6a2/STATE.a2ml‎

Lines changed: 24 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,64 +1,42 @@
11
# SPDX-License-Identifier: PMPL-1.0-or-later
2-
# Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
33
#
4-
# STATE.a2ml — Project state checkpoint (META-TEMPLATE)
5-
#
6-
# This is the STATE file for rsr-template-repo itself.
7-
# When consumed by a new project, replace {{PLACEHOLDER}} tokens
8-
# and customize sections below for the target project.
4+
# STATE.a2ml — Project state for gv-clade-index
95

106
[metadata]
11-
project = "rsr-template-repo"
12-
version = "0.2.0"
13-
last-updated = "2026-02-28"
14-
status = "active" # active | paused | archived
7+
project = "gv-clade-index"
8+
version = "0.1.0"
9+
last-updated = "2026-03-16"
10+
status = "active"
1511

1612
[project-context]
17-
name = "rsr-template-repo"
18-
purpose = "Canonical RSR-compliant repository template providing scaffolding for all hyperpolymath projects — including CI/CD, AI manifests, ABI/FFI standards, container ecosystem, and governance infrastructure."
19-
completion-percentage = 95
13+
name = "gv-clade-index"
14+
purpose = "VeriSimDB-backed clade taxonomy and central registry for the hyperpolymath ecosystem (200+ repos)"
15+
completion-percentage = 10
2016

2117
[position]
22-
phase = "maintenance" # design | implementation | testing | maintenance | archived
23-
maturity = "production" # experimental | alpha | beta | production | lts
18+
phase = "implementation"
19+
maturity = "alpha"
2420

2521
[route-to-mvp]
2622
milestones = [
27-
{ name = "Phase 0: Core scaffolding (justfile, CI/CD, .machine_readable)", completion = 100 },
28-
{ name = "Phase 1: ABI/FFI standard (Idris2/Zig templates)", completion = 100 },
29-
{ name = "Phase 1b: AI Gatekeeper Protocol (0-AI-MANIFEST.a2ml)", completion = 100 },
30-
{ name = "Phase 1c: TOPOLOGY.md standard and guide", completion = 100 },
31-
{ name = "Phase 1d: Maintenance gate (axes, checklist, approach)", completion = 100 },
32-
{ name = "Phase 1e: Trustfile / contractiles", completion = 100 },
33-
{ name = "Phase 2: Container ecosystem templates (stapeln)", completion = 100 },
34-
{ name = "Phase 3: Multi-forge sync hardening", completion = 0 },
35-
{ name = "Phase 4: Nix/Guix reproducible shells", completion = 50 },
23+
{ name = "Phase 0: Clade taxonomy, repo seed, VQL schema, queries", completion = 100 },
24+
{ name = "Phase 1: Deploy CLADE.a2ml to all 200 repos", completion = 0 },
25+
{ name = "Phase 2: VeriSimDB instance on VPS, ingest data", completion = 0 },
26+
{ name = "Phase 3: Cloudflare Worker API endpoints", completion = 0 },
27+
{ name = "Phase 4: ReScript/WASM portal on github.io", completion = 0 },
28+
{ name = "Phase 5: LLM query endpoint", completion = 0 },
29+
{ name = "Phase 6: Bot write endpoints + TODO octads", completion = 0 },
30+
{ name = "Phase 7: Contributor OAuth + scoped repo access", completion = 0 },
31+
{ name = "Phase 8: Repo lockdown (visibility management)", completion = 0 },
3632
]
3733

3834
[blockers-and-issues]
39-
# No active blockers
35+
# None at Phase 0
4036

4137
[critical-next-actions]
4238
actions = [
43-
"Container templates complete — test with `just container-init`",
44-
"Validate container templates across wolfi-base and static Chainguard images",
45-
"Harden multi-forge sync for GitLab/Bitbucket mirroring edge cases",
46-
"Expand Nix/Guix development shell templates",
39+
"Deploy CLADE.a2ml to all 200 repos (batch script)",
40+
"Stand up VeriSimDB instance on Verpex VPS",
41+
"Write sync/ingest tooling in Rust",
4742
]
48-
49-
[maintenance-status]
50-
last-run-utc = "never"
51-
last-report = "docs/reports/maintenance/latest.json"
52-
last-result = "unknown" # unknown | pass | warn | fail
53-
open-warnings = 0
54-
open-failures = 0
55-
56-
[ecosystem]
57-
part-of = ["RSR Framework", "stapeln ecosystem"]
58-
depends-on = ["stapeln", "selur-compose", "cerro-torre", "svalinn", "vordr", "k9-svc"]
59-
60-
# ---------------------------------------------------------------------------
61-
# NOTE FOR CONSUMERS: When using this template to create a new repo, reset
62-
# the fields above to your project's values and replace all {{PLACEHOLDER}}
63-
# tokens. The milestones above describe the TEMPLATE's evolution, not yours.
64-
# ---------------------------------------------------------------------------

‎.machine_readable/CLADE.a2ml‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Clade declaration for gv-clade-index itself
3+
4+
[identity]
5+
uuid = "a1b2c3d4-e5f6-5789-abcd-ef0123456789"
6+
primary-forge = "github"
7+
primary-owner = "hyperpolymath"
8+
canonical-name = "gv-clade-index"
9+
prefixed-name = "gv-clade-index"
10+
11+
[clade]
12+
primary = "gv"
13+
secondary = ["db"]
14+
assigned = "2026-03-16"
15+
rationale = "This is a governance registry backed by a database; governance is the primary purpose"
16+
17+
[forges]
18+
github = "hyperpolymath/gv-clade-index"
19+
gitlab = "hyperpolymath/gv-clade-index"
20+
bitbucket = "hyperpolymath/gv-clade-index"
21+
22+
[lineage]
23+
type = "standalone"
24+
parent = ""
25+
born = "2026-03-16"

0 commit comments

Comments
 (0)