Skip to content

Commit 02fd283

Browse files
hyperpolymathclaude
andcommitted
chore(6a2): commit pre-existing 6a2 sweep for echidnabot, HOL-o-extension, echidna-playground
Files were converted from SCM format and filled in by a prior session but never staged/committed. Covers AGENTIC, ECOSYSTEM, META, NEUROSYM, PLAYBOOK, STATE for each sub-project. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 390070b commit 02fd283

14 files changed

Lines changed: 363 additions & 222 deletions

File tree

Lines changed: 20 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,20 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
;; ECOSYSTEM.scm — HOL-o-extension ecosystem position
3-
4-
(ecosystem
5-
((metadata
6-
((version . "0.1.0")
7-
(name . "HOL-o-extension")
8-
(type . "o-extension")
9-
(purpose . "Optional overlay extending HOL4 with custom theories and tactics for ECHIDNA integration")))
10-
11-
(overlay-protocol
12-
((base . "../HOL")
13-
(upstream . "https://github.com/HOL-Theorem-Prover/HOL")
14-
(peer-type . "o-extension")
15-
(activation . "source activate.sh")
16-
(deactivation . "unset HOL_OEXT_ACTIVE; unset HOL_OEXT_DIR")
17-
(switchable . #t)
18-
(modifies-base . #f)
19-
(description . "Optional-extension pattern: never touches base code, purely additive overlay that can be toggled on/off per-run. When active, extends HOL's load path with custom theories and tactics. When inactive, HOL behaves as virgin upstream.")))
20-
21-
(position-in-ecosystem
22-
"HOL-o-extension is a peer-level sibling to the upstream HOL4 theorem prover within the ECHIDNA monorepo. It provides custom theories and tactics needed for ECHIDNA's neurosymbolic proof search without forking or modifying HOL itself. This follows the Overlay Protocol, where overlays declare their relationship to a base project and maintain strict non-modification invariants.")
23-
24-
(related-projects
25-
((base-project
26-
((hol4
27-
((relationship . "base")
28-
(description . "HOL4 higher-order logic theorem prover (upstream)")
29-
(path . "../HOL")
30-
(upstream . "https://github.com/HOL-Theorem-Prover/HOL")
31-
(interaction . "Load path extension, never modification")))))
32-
33-
(parent-project
34-
((echidna
35-
((relationship . "parent-monorepo")
36-
(description . "ECHIDNA neurosymbolic theorem prover")
37-
(path . "..")
38-
(interaction . "HOL4 backend uses o-extension theories when activated")))))
39-
40-
(overlay-protocol-peers
41-
;; Other projects using the Overlay Protocol pattern
42-
((proven-aggregate-lib
43-
((relationship . "protocol-peer")
44-
(peer-type . "aggregate-library")
45-
(description . "Curated subset of proven bindings — same Overlay Protocol, different peer-type")
46-
(status . "active")
47-
(notes . "aggregate-library selects/re-exports; o-extension adds new capabilities. Both verified conformant.")))))))
48-
49-
(what-this-is
50-
(("An optional overlay for HOL4 within ECHIDNA"
51-
"Custom theories for neurosymbolic proof search"
52-
"Additional tactics for ECHIDNA-specific proof strategies"
53-
"Switchable per-run — activate.sh to enable, unset to disable"
54-
"Part of the Overlay Protocol (peer-type: o-extension)")))
55-
56-
(what-this-is-not
57-
(("Not a fork of HOL — upstream is rebased, never patched"
58-
"Not a dependency — HOL works fine without it"
59-
"Not an aggregate-library — it adds new things, not curates existing ones"
60-
"Not permanent — can be toggled off for vanilla HOL behaviour")))))
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# ECOSYSTEM.a2ml — HOL O Extension ecosystem position
5+
[metadata]
6+
version = "0.1.0"
7+
last-updated = "2026-04-11"
8+
9+
[project]
10+
name = "HOL O Extension"
11+
purpose = "Optional overlay extending HOL4 with custom theories and tactics for ECHIDNA integration"
12+
role = "o-extension"
13+
14+
[position-in-ecosystem]
15+
category = ""
16+
17+
[related-projects]
18+
projects = [
19+
{ name = "HOL-o-extension", relationship = "base" },
20+
]
Lines changed: 23 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,27 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
;; META.scm — HOL-o-extension meta-level information
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# META.a2ml — HOL O Extension meta-level information
5+
[metadata]
6+
version = "0.1.0"
7+
last-updated = "2026-04-11"
38

4-
(meta
5-
((metadata
6-
((version . "0.1.0")
7-
(media-type . "application/meta+scheme")))
9+
[project-info]
10+
license = "PMPL-1.0-or-later"
11+
author = "Jonathan D.A. Jewell (hyperpolymath)"
812

9-
(architecture-decisions
10-
((adr-001
11-
((title . "Use o-extension pattern instead of forking HOL")
12-
(status . "accepted")
13-
(date . "2026-03-07")
14-
(context . "ECHIDNA needs custom theories and tactics for HOL4 integration. Options: fork HOL, patch HOL, or overlay alongside HOL.")
15-
(decision . "Use the o-extension (optional-extension) pattern: a peer-level directory that overlays HOL via environment variables without modifying any upstream files.")
16-
(rationale . "Forking creates maintenance burden tracking upstream. Patching breaks on rebase. The o-extension pattern keeps HOL pristine, allows clean rebasing, and can be toggled on/off per-run.")
17-
(consequences . ("HOL upstream can be rebased freely"
18-
"No merge conflicts with upstream"
19-
"Slightly more complex activation (must source activate.sh)"
20-
"Custom theories must be self-contained"))))
13+
[architecture-decisions]
14+
decisions = [
15+
# No ADRs recorded
16+
]
2117

22-
(adr-002
23-
((title . "Overlay Protocol as shared pattern with aggregate-library")
24-
(status . "accepted")
25-
(date . "2026-03-07")
26-
(context . "Both o-extension and aggregate-library share core invariants: never modify base, switchable, declared relationship.")
27-
(decision . "Formalize both as instances of the Overlay Protocol, differentiated by peer-type (o-extension vs aggregate-library) and activation-method (flag vs dependency).")
28-
(rationale . "Unifying under one protocol makes the patterns discoverable, composable, and consistently documented across the ecosystem.")
29-
(consequences . ("ECOSYSTEM.scm gains overlay-protocol section"
30-
"Both patterns can reference each other as protocol-peers"
31-
"Future overlay types can extend the protocol"))))))
18+
[development-practices]
19+
versioning = "SemVer"
20+
documentation = "AsciiDoc"
21+
build-tool = "just"
3222

33-
(development-practices
34-
((sml-conventions
35-
((description . "HOL4 uses Standard ML (SML). All theories and tactics in this o-extension are written in SML.")
36-
(style . "Follow HOL4 naming conventions for theories and tactics")))
37-
38-
(testing
39-
((description . "Test by loading theories with and without o-extension active")
40-
(approach . "Activation/deactivation cycle must be idempotent")))))))
23+
[maintenance-axes]
24+
scoping-first = true
25+
axis-1 = "must > intend > like"
26+
axis-2 = "corrective > adaptive > perfective"
27+
axis-3 = "systems > compliance > effects"
Lines changed: 34 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,40 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
;; STATE.scm — HOL-o-extension project state
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# STATE.a2ml — HOL O Extension project state
5+
[metadata]
6+
project = "HOL-o-extension"
7+
version = "0.1.0"
8+
last-updated = "2026-03-07"
9+
status = "active"
10+
session = "converted from scheme — 2026-04-11"
311

4-
(state
5-
((metadata
6-
((version . "0.1.0")
7-
(last-updated . "2026-03-07")
8-
(author . "Jonathan D.A. Jewell")))
12+
[project-context]
13+
name = "HOL O Extension"
14+
purpose = """activate.sh sets environment for HOL load path extension"""
15+
completion-percentage = 0
916

10-
(project-context
11-
((name . "HOL-o-extension")
12-
(type . "o-extension")
13-
(base . "HOL4 Theorem Prover")
14-
(parent . "ECHIDNA")))
17+
[position]
18+
phase = "scaffolding" # design | implementation | testing | maintenance | archived
19+
maturity = "experimental" # experimental | alpha | beta | production | lts
1520

16-
(current-position
17-
((phase . "scaffolding")
18-
(completion . 5)
19-
(status . "Directory structure and overlay protocol declared. Theories and tactics not yet populated.")))
21+
[route-to-mvp]
22+
milestones = [
23+
{ name = "HOL-o-extension", completion = 5 },
24+
]
2025

21-
(route-to-mvp
22-
((milestone-1
23-
((name . "Activation mechanism")
24-
(status . "complete")
25-
(description . "activate.sh sets environment for HOL load path extension")))
26-
(milestone-2
27-
((name . "First custom theory")
28-
(status . "pending")
29-
(description . "Create an ECHIDNA-specific HOL4 theory (e.g., trust levels, confidence types)")))
30-
(milestone-3
31-
((name . "First custom tactic")
32-
(status . "pending")
33-
(description . "Create an ECHIDNA-specific HOL4 tactic (e.g., neurosymbolic_suggest)")))
34-
(milestone-4
35-
((name . "ECHIDNA HOL4 backend integration")
36-
(status . "pending")
37-
(description . "Wire o-extension into ECHIDNA's HOL4 prover backend")))))
26+
[blockers-and-issues]
27+
issues = [
28+
# No blockers recorded
29+
]
3830

39-
(blockers-and-issues
40-
((none-currently . #t)))
31+
[critical-next-actions]
32+
actions = [
33+
"Define first custom HOL4 theory for ECHIDNA trust types",
34+
"Create neurosymbolic tactic stubs",
35+
"Test activate/deactivate cycle end-to-end",
36+
]
4137

42-
(critical-next-actions
43-
(("Define first custom HOL4 theory for ECHIDNA trust types"
44-
"Create neurosymbolic tactic stubs"
45-
"Test activate/deactivate cycle end-to-end")))))
38+
[maintenance-status]
39+
last-run-utc = "2026-03-07T00:00:00Z"
40+
last-result = "unknown" # unknown | pass | warn | fail
Lines changed: 34 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,34 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
;; Reserved for future use.
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# AGENTIC.a2ml — AI agent constraints and capabilities
5+
[metadata]
6+
version = "0.1.0"
7+
last-updated = "2026-04-11"
8+
9+
[agent-permissions]
10+
can-edit-source = true
11+
can-edit-tests = true
12+
can-edit-docs = true
13+
can-edit-config = true
14+
can-create-files = true
15+
16+
[agent-constraints]
17+
# What AI agents must NOT do:
18+
# - Never use banned language patterns (believe_me, unsafeCoerce, etc.)
19+
# - Never commit secrets or credentials
20+
# - Never use banned languages (TypeScript, Python, Go, etc.)
21+
# - Never place state files in repository root (must be in .machine_readable/)
22+
# - Never use AGPL license (use PMPL-1.0-or-later)
23+
24+
[maintenance-integrity]
25+
fail-closed = true
26+
require-evidence-per-step = true
27+
allow-silent-skip = false
28+
require-rerun-after-fix = true
29+
release-claim-requires-hard-pass = true
30+
31+
[automation-hooks]
32+
# on-enter: Read 0-AI-MANIFEST.a2ml, then STATE.a2ml
33+
# on-exit: Update STATE.a2ml with session outcomes
34+
# on-commit: Run just validate-rsr
Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,20 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
(ecosystem (metadata (version "0.1.0") (last-updated "2026-02-08"))
3-
(project (name "language-bridges") (purpose "FFI bridges between languages via Zig") (role ffi-infrastructure)))
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# ECOSYSTEM.a2ml — Echidna Playground ecosystem position
5+
[metadata]
6+
version = "0.1.0"
7+
last-updated = "2026-02-08"
8+
9+
[project]
10+
name = "Echidna Playground"
11+
purpose = "FFI bridges between languages via Zig"
12+
role = ""
13+
14+
[position-in-ecosystem]
15+
category = ""
16+
17+
[related-projects]
18+
projects = [
19+
# No related projects recorded
20+
]
Lines changed: 27 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,27 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
(meta (metadata (version "0.1.0") (last-updated "2026-02-08"))
3-
(project-info (type monorepo) (languages (zig ada gleam idris2 julia ocaml rescript rust swift)) (license "PMPL-1.0-or-later")))
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# META.a2ml — Echidna Playground meta-level information
5+
[metadata]
6+
version = "0.1.0"
7+
last-updated = "2026-02-08"
8+
9+
[project-info]
10+
license = "PMPL-1.0-or-later"
11+
author = "Jonathan D.A. Jewell (hyperpolymath)"
12+
13+
[architecture-decisions]
14+
decisions = [
15+
# No ADRs recorded
16+
]
17+
18+
[development-practices]
19+
versioning = "SemVer"
20+
documentation = "AsciiDoc"
21+
build-tool = "just"
22+
23+
[maintenance-axes]
24+
scoping-first = true
25+
axis-1 = "must > intend > like"
26+
axis-2 = "corrective > adaptive > perfective"
27+
axis-3 = "systems > compliance > effects"
Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,21 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
;; Reserved for future use.
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# NEUROSYM.a2ml — Neurosymbolic integration metadata
5+
[metadata]
6+
version = "0.1.0"
7+
last-updated = "2026-04-11"
8+
9+
[hypatia-config]
10+
scan-enabled = true
11+
scan-depth = "standard" # quick | standard | deep
12+
report-format = "logtalk"
13+
14+
[symbolic-rules]
15+
# Custom symbolic rules for this project
16+
# - { name = "no-unsafe-ffi", pattern = "believe_me|unsafeCoerce", severity = "critical" }
17+
18+
[neural-config]
19+
# Neural pattern detection settings
20+
# confidence-threshold = 0.85
21+
# model = "hypatia-v2"
Lines changed: 26 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,26 @@
1-
;; SPDX-License-Identifier: PMPL-1.0-or-later
2-
;; Reserved for future use.
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
3+
#
4+
# PLAYBOOK.a2ml — Operational playbook
5+
[metadata]
6+
version = "0.1.0"
7+
last-updated = "2026-04-11"
8+
9+
[deployment]
10+
# method = "gitops" # gitops | manual | ci-triggered
11+
# target = "container" # container | binary | library | wasm
12+
13+
[incident-response]
14+
# 1. Check .machine_readable/STATE.a2ml for current status
15+
# 2. Review recent commits and CI results
16+
# 3. Run `just validate` to check compliance
17+
# 4. Run `just security` to audit for vulnerabilities
18+
19+
[release-process]
20+
# 1. Update version in STATE.a2ml, META.a2ml
21+
# 2. Run `just release-preflight` (validate + quality + security + maint-hard-pass)
22+
# 3. Tag and push
23+
24+
[maintenance-operations]
25+
# Baseline audit: just maint-audit
26+
# Hard release gate: just maint-hard-pass

0 commit comments

Comments
 (0)