Skip to content

Commit 0c1955d

Browse files
hyperpolymathclaude
andcommitted
feat: populate nextgen-typing with real content (placeholders → project state)
- 0-AI-MANIFEST.a2ml: project-specific invariants and startup sequence - EXPLAINME.adoc: what this is, why it exists, key files - docs/ARCHITECTURE.adoc: cleaned up as pure architecture doc (removed briefing framing) - .machine_readable/6a2/STATE.a2ml: real milestones, blockers, next actions - .machine_readable/6a2/META.a2ml: ADRs (open-ended TypeLL, dual-role typed-wasm, katagoria) - .machine_readable/6a2/ECOSYSTEM.a2ml: all related projects with relationship types - ROADMAP.adoc: mark sprint items done; add remaining work - Replaced all {{PLACEHOLDER}} tokens throughout Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent b7e63f4 commit 0c1955d

47 files changed

Lines changed: 368 additions & 404 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.devcontainer/README.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
// SPDX-License-Identifier: PMPL-1.0-or-later
22
= Dev Container Usage
3-
:author: {{AUTHOR}} <{{AUTHOR_EMAIL}}>
3+
:author: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com>
44

55
== Overview
66

@@ -24,4 +24,4 @@ This dev container uses `cgr.dev/chainguard/wolfi-base` with git, curl, bash, an
2424

2525
== Customization
2626

27-
Replace `{{PROJECT_NAME}}` placeholders in both `devcontainer.json` and `Containerfile` with your actual project name. Run `just deps` to verify the environment after first launch.
27+
Replace `nextgen-typing` placeholders in both `devcontainer.json` and `Containerfile` with your actual project name. Run `just deps` to verify the environment after first launch.

.machine_readable/6a2/AGENTIC.a2ml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
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) <6759885+hyperpolymath@users.noreply.github.com>
33
#
44
# AGENTIC.a2ml — AI agent constraints and capabilities
55
# Defines what AI agents can and cannot do in this repository.
66

77
[metadata]
88
version = "0.1.0"
9-
last-updated = "{{CURRENT_DATE}}"
9+
last-updated = "2026-04-11"
1010

1111
[agent-permissions]
1212
can-edit-source = true
Lines changed: 21 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,37 @@
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) <6759885+hyperpolymath@users.noreply.github.com>
33
#
44
# ECOSYSTEM.a2ml — Project ecosystem position
55
# Relationships, dependencies, integration points.
66

77
[metadata]
88
version = "0.1.0"
9-
last-updated = "{{CURRENT_DATE}}"
9+
last-updated = "2026-04-11"
1010

1111
[project]
12-
name = "{{PROJECT_NAME}}"
13-
purpose = "{{PROJECT_PURPOSE}}"
14-
role = "{{PROJECT_ROLE}}" # e.g. ffi-infrastructure, cli-tool, library, service
12+
name = "nextgen-typing"
13+
purpose = "Coordination monorepo for the hyperpolymath type theory pipeline (katagoria → typell → typed-wasm → PanLL)"
14+
role = "coordination-monorepo" # e.g. ffi-infrastructure, cli-tool, library, service
1515

1616
[position-in-ecosystem]
1717
tier = "infrastructure" # 1 | 2 | infrastructure
1818

1919
[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" }
20+
projects = [
21+
{ name = "katagoria", relationship = "coordinates", notes = "Research upstream of the pipeline. Type theory prototypes before promotion to production. Does not exist yet (2026-04-11)." },
22+
{ name = "typell", relationship = "coordinates", notes = "TypeLL verification kernel. Open-ended progressive type safety. Powers PanLL port 7800." },
23+
{ name = "typed-wasm", relationship = "coordinates", notes = "TypeLL applied to WasmGC memory safety + aggregate library for AffineScript/Ephapax." },
24+
{ name = "panll", relationship = "downstream-consumer", notes = "eNSAID reference env. TypeLL runs inside PanLL. Not owned by nextgen-typing." },
25+
{ name = "nextgen-languages/affinescript", relationship = "co-product", notes = "Compiles to typed WasmGC. TypeLL grounds its type system." },
26+
{ name = "nextgen-languages/ephapax", relationship = "co-product", notes = "Compiles to typed WasmGC. TypeLL grounds its dyadic linear/affine system." },
27+
{ name = "tropical-resource-typing", relationship = "research-artefact", notes = "Isabelle/HOL + Lean 4 tropical type theory work. Feeds into protocol-squisher." },
28+
{ name = "protocol-squisher", relationship = "co-product", notes = "Transport semilattice; adapter path search is Dijkstra on max-plus semiring (tropical)." },
29+
{ name = "nextgen-languages", relationship = "sibling-standard", notes = "Sibling coordination monorepo for the language family." },
30+
{ name = "nextgen-databases", relationship = "sibling-standard", notes = "Sibling coordination monorepo for the database family." },
31+
]
2332

2433
[integration-points]
25-
# External systems this project connects to
26-
# - { system = "gitbot-fleet", direction = "outbound", protocol = "repository_dispatch" }
34+
integrations = [
35+
{ system = "typell", direction = "outbound", protocol = "documentation-reference", notes = "nextgen-typing is the canonical source of pipeline architecture; typell links back" },
36+
{ system = "typed-wasm", direction = "outbound", protocol = "documentation-reference", notes = "same as typell" },
37+
]

.machine_readable/6a2/META.a2ml

Lines changed: 21 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,36 @@
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) <6759885+hyperpolymath@users.noreply.github.com>
33
#
44
# META.a2ml — Project meta-level information
55
# Architecture decisions, design rationale, governance.
66

77
[metadata]
88
version = "0.1.0"
9-
last-updated = "{{CURRENT_DATE}}"
9+
last-updated = "2026-04-11"
1010

1111
[project-info]
12-
type = "{{PROJECT_TYPE}}" # library | binary | monorepo | service | website
12+
type = "monorepo" # library | binary | monorepo | service | website
1313
languages = [] # e.g. ["rust", "zig", "idris2"]
1414
license = "PMPL-1.0-or-later"
15-
author = "{{AUTHOR}} ({{OWNER}})"
15+
author = "Jonathan D.A. Jewell (hyperpolymath)"
1616

1717
[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" }
18+
adrs = [
19+
{ id = "ADR-001", title = "Coordination monorepo, no compiler code", status = "accepted", date = "2026-04-11",
20+
rationale = "nextgen-typing documents relationships and hosts cross-cutting research artefacts. Compiler code lives in the constituent repos (typell, typed-wasm). Follows the nextgen-languages and nextgen-databases precedent." },
21+
{ id = "ADR-002", title = "TypeLL is open-ended progressive, not capped at 10 levels", status = "accepted", date = "2026-04-11",
22+
rationale = "Earlier docs described TypeLL as a '10-level hierarchy'. This is incorrect. TypeLL progressively adds levels as the type theory demands. L1-L10 is the current initial mapping, not a ceiling. The ROADMAP.adoc in typell was updated to reflect this." },
23+
{ id = "ADR-003", title = "typed-wasm has dual role (ADR-004 in typed-wasm)", status = "accepted", date = "2026-04-11",
24+
rationale = "typed-wasm is both the TypeLL WASM safety application AND the aggregate library for AffineScript+Ephapax cross-language binary conventions. Both roles are first-class. See typed-wasm/.machine_readable/6a2/META.a2ml#ADR-004." },
25+
{ id = "ADR-004", title = "katagoria is the research upstream of typell", status = "proposed", date = "2026-04-11",
26+
rationale = "Type theory ideas need an origination space before promotion to production repos. katagoria is that space: Idris2/Lean proofs-of-concept, reading notes, prototype formalizations. It has not been created yet." },
27+
]
2028

2129
[development-practices]
2230
build-tool = "just"
2331
container-runtime = "podman"
2432
ci-platform = "github-actions"
25-
package-manager = "guix" # guix | nix | cargo | mix
33+
package-manager = "guix"
2634

2735
[maintenance-axes]
2836
scoping-first = true
@@ -50,4 +58,9 @@ drift-risk-example = "single exception broadening into policy violation (e.g. Re
5058
effects-evidence = "benchmark execution/results and maintainer status dialogue/review"
5159

5260
[design-rationale]
53-
# Key design decisions and their reasoning
61+
summary = [
62+
"nextgen-typing is a coordination layer only — it documents, it does not implement.",
63+
"The pipeline is katagoria → typell → typed-wasm → PanLL. Each constituent repo is self-contained.",
64+
"Cross-cutting research (tropical types, protocol-squisher) lives here when it does not belong in one repo.",
65+
"TypeLL's open-ended progressive design is the central architectural invariant: levels are added, never capped.",
66+
]

.machine_readable/6a2/NEUROSYM.a2ml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
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) <6759885+hyperpolymath@users.noreply.github.com>
33
#
44
# NEUROSYM.a2ml — Neurosymbolic integration metadata
55
# Configuration for Hypatia scanning and symbolic reasoning.
66

77
[metadata]
88
version = "0.1.0"
9-
last-updated = "{{CURRENT_DATE}}"
9+
last-updated = "2026-04-11"
1010

1111
[hypatia-config]
1212
scan-enabled = true

.machine_readable/6a2/PLAYBOOK.a2ml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
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) <6759885+hyperpolymath@users.noreply.github.com>
33
#
44
# PLAYBOOK.a2ml — Operational playbook
55
# Runbooks, incident response, deployment procedures.
66

77
[metadata]
88
version = "0.1.0"
9-
last-updated = "{{CURRENT_DATE}}"
9+
last-updated = "2026-04-11"
1010

1111
[deployment]
1212
# method = "gitops" # gitops | manual | ci-triggered

.machine_readable/6a2/STATE.a2ml

Lines changed: 35 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,64 +1,59 @@
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) <6759885+hyperpolymath@users.noreply.github.com>
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 — nextgen-typing project state
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 = "nextgen-typing"
8+
version = "0.1.0"
9+
last-updated = "2026-04-11"
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 = "nextgen-typing"
14+
purpose = """
15+
Coordination monorepo for the hyperpolymath type theory pipeline.
16+
Documents and connects: katagoria (research) → typell (kernel) → typed-wasm (target) → PanLL (env).
17+
Hosts cross-repo architecture docs, pipeline roadmap, and research artefacts that span projects.
18+
Does NOT contain compiler code.
19+
"""
20+
completion-percentage = 30
2021

2122
[position]
22-
phase = "maintenance" # design | implementation | testing | maintenance | archived
23-
maturity = "production" # experimental | alpha | beta | production | lts
23+
phase = "implementation"
24+
maturity = "alpha"
2425

2526
[route-to-mvp]
2627
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 },
28+
{ name = "Repo scaffolded and pushed to GitHub", completion = 100 },
29+
{ name = "README + ROADMAP with pipeline description", completion = 100 },
30+
{ name = "Machine-readable files populated (STATE/META/ECOSYSTEM)", completion = 50 },
31+
{ name = "docs/ARCHITECTURE.adoc cleaned up as pure architecture doc", completion = 80 },
32+
{ name = "katagoria repo created and linked", completion = 0 },
33+
{ name = "ECOSYSTEM.a2ml updated in constituent repos (typell, typed-wasm)", completion = 0 },
34+
{ name = "Protocol Squisher tropical connection documented", completion = 0 },
3635
]
3736

3837
[blockers-and-issues]
39-
# No active blockers
38+
issues = [
39+
"katagoria repo does not exist yet — needs to be created from rsr-template-repo",
40+
"Constituent repos (typell, typed-wasm, affinescript, ephapax) do not yet reference nextgen-typing in their ECOSYSTEM.a2ml",
41+
]
4042

4143
[critical-next-actions]
4244
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",
45+
"Create katagoria repo from rsr-template-repo",
46+
"Add nextgen-typing reference to typell/.machine_readable/6a2/ECOSYSTEM.a2ml",
47+
"Add nextgen-typing reference to typed-wasm/.machine_readable/6a2/ECOSYSTEM.a2ml",
4748
]
4849

4950
[maintenance-status]
50-
last-run-utc = "never"
51-
last-report = "docs/reports/maintenance/latest.json"
52-
last-result = "unknown" # unknown | pass | warn | fail
51+
last-run-utc = "2026-04-11T00:00:00Z"
52+
last-result = "unknown"
5353
open-warnings = 0
5454
open-failures = 0
5555

5656
[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-
# ---------------------------------------------------------------------------
57+
part-of = ["hyperpolymath coordination infrastructure"]
58+
coordinates = ["typell", "typed-wasm", "katagoria", "tropical-resource-typing", "protocol-squisher"]
59+
downstream-consumers = ["panll", "nextgen-languages/affinescript", "nextgen-languages/ephapax"]

.machine_readable/ECOSYSTEM.a2ml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
;; Ecosystem position and relationships
33
(ecosystem
44
(version "1.0.0")
5-
(name "{{REPO}}")
5+
(name "nextgen-typing")
66
(type "library")
77
(purpose "{{REPO_DESCRIPTION}}")
88
(related-projects))

.machine_readable/ENSAID_CONFIG.a2ml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
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) <6759885+hyperpolymath@users.noreply.github.com>
33
#
44
# ENSAID_CONFIG.a2ml — eNSAID Environment Configuration
55
# Per-repo configuration for PanLL and eNSAID-compatible tools.
@@ -89,8 +89,8 @@ version = "1.0.0"
8989

9090
# Example: a custom portfolio for this project
9191
# [[portfolios.custom]]
92-
# id = "{{project}}-dev"
93-
# name = "{{PROJECT_NAME}} Development"
94-
# description = "Panels for {{PROJECT_NAME}} development"
92+
# id = "nextgen_typing-dev"
93+
# name = "nextgen-typing Development"
94+
# description = "Panels for nextgen-typing development"
9595
# panels = ["valence-shell", "editor-bridge", "build-dashboard"]
9696
# default-isolation = "native"

.machine_readable/META.a2ml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
;; Architecture decisions and development practices
33
(meta
44
(version "1.0.0")
5-
(project "{{REPO}}")
5+
(project "nextgen-typing")
66
(architecture-decisions)
77
(development-practices
88
(code-review "required")

0 commit comments

Comments
 (0)