-
-
Notifications
You must be signed in to change notification settings - Fork 0
Chore/training infrastructure cleanups #334
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. Weβll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
hyperpolymath
wants to merge
8
commits into
main
Choose a base branch
from
chore/training-infrastructure-cleanups
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
7543fee
chore(training): EchidnaML CUDA logging fix + per-stage run doc
hyperpolymath c73c40e
Merge remote-tracking branch 'origin/main' into chore/training-infrasβ¦
hyperpolymath 1913578
chore(contractiles): reconcile to standards canonical subdir layout; β¦
hyperpolymath 1a33cf0
docs(governance): add GOVERNANCE.adoc (required by must/Mustfile goveβ¦
hyperpolymath c468aa9
fix(ci): complete TruffleHog secret-scan migration; remove gitleaks
hyperpolymath e80c870
ci: adopt standards reusable workflows for Scorecard, Hypatia, and Goβ¦
hyperpolymath 06029be
ci: adopt standards reusable workflows for Scorecard, Hypatia, and Goβ¦
hyperpolymath 06b153a
ci: adopt standards reusable workflows for Scorecard, Hypatia, and Goβ¦
hyperpolymath File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,34 +1,16 @@ | ||
| # SPDX-License-Identifier: MPL-2.0 | ||
| # governance.yml β single wrapper calling the shared estate governance bundle | ||
| # in hyperpolymath/standards instead of carrying per-repo copies. | ||
| # | ||
| # Replaces the per-repo governance scaffolding removed in the same commit: | ||
| # quality.yml, guix-nix-policy.yml, npm-bun-blocker.yml, ts-blocker.yml, | ||
| # security-policy.yml, rsr-antipattern.yml, wellknown-enforcement.yml, | ||
| # workflow-linter.yml | ||
| # | ||
| # Load-bearing build/security workflows stay standalone in the repo | ||
| # (rust-ci, codeql, dependabot, release, scan/mirror/pages plumbing). | ||
|
|
||
| # SPDX-License-Identifier: PMPL-1.0-or-later | ||
| name: Governance | ||
|
|
||
| on: | ||
| push: | ||
| branches: [main, master] | ||
| pull_request: | ||
| branches: [main, master] | ||
| workflow_dispatch: | ||
|
|
||
| # Estate guardrail: cancel superseded runs so re-pushes / rebased PR | ||
| # updates do not pile up queued runs against the shared account-wide | ||
| # Actions concurrency pool. Applied only to read-only check workflows | ||
| # (no publish/mutation), so cancelling a superseded run is always safe. | ||
| concurrency: | ||
| group: ${{ github.workflow }}-${{ github.ref }} | ||
| cancel-in-progress: true | ||
|
|
||
| permissions: | ||
| contents: read | ||
|
|
||
| jobs: | ||
| governance: | ||
| uses: hyperpolymath/standards/.github/workflows/governance-reusable.yml@3f34549c03274ec7a74683068f03a492b0fa805f # main 2026-06-01 (R5 generic β standards#330; consumes .github/canonical-references/) | ||
| uses: hyperpolymath/standards/.github/workflows/governance-reusable.yml@5a93d9d57cc04de4002d6d0ecd336fc7a8698910 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,19 +1,16 @@ | ||
| # SPDX-License-Identifier: MPL-2.0 | ||
| name: Scorecards supply-chain security | ||
| # SPDX-License-Identifier: PMPL-1.0-or-later | ||
| name: OSSF Scorecard | ||
|
|
||
| on: | ||
| branch_protection_rule: | ||
| schedule: | ||
| - cron: '23 4 * * 1' | ||
| push: | ||
| branches: [main] | ||
| branches: [main, master] | ||
| schedule: | ||
| - cron: '0 4 * * *' | ||
| workflow_dispatch: | ||
|
|
||
| permissions: read-all | ||
| permissions: | ||
| contents: read | ||
|
|
||
| jobs: | ||
| analysis: | ||
| permissions: | ||
| security-events: write | ||
| id-token: write | ||
| uses: hyperpolymath/standards/.github/workflows/scorecard-reusable.yml@e03686486e11b662834d7090dffae54c3e96fd59 # main 2026-05-28 (SPDX bump #249) | ||
| secrets: inherit | ||
| scorecard: | ||
| uses: hyperpolymath/standards/.github/workflows/scorecard-reusable.yml@5a93d9d57cc04de4002d6d0ecd336fc7a8698910 | ||
|
hyperpolymath marked this conversation as resolved.
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,151 @@ | ||
| // SPDX-License-Identifier: MPL-2.0 | ||
| // Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk> | ||
| = Echidna Contractiles | ||
| Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> | ||
| :toc: | ||
| :sectnums: | ||
|
|
||
| This directory holds Echidna's *contractiles* β the machine-readable | ||
| contracts that make the project's invariants, trust boundary, recovery | ||
| story, drift tolerances, hard-stop conditions, and north-star intent | ||
| legible to CI, the contractile CLI, and Hypatia rules. | ||
|
|
||
| Echidna is a trust-hardened neurosymbolic theorem-proving platform, so | ||
| these contracts are not decorative: `must` and `trust` gate merges, | ||
| `bust` declares deprecated-path hard-stops, and `dust` governs how | ||
| recovery happens without losing the audit trail. | ||
|
|
||
| The estate-level audit semantics (what each verb *means* and the | ||
| minimum bar for "real contract vs template residue") are defined in | ||
| `standards/contractiles/CANONICAL-TEMPLATES.adoc`. The normative | ||
| per-file specification is `docs/CONTRACTILE-SPEC.adoc`. This README | ||
| documents the local realisation. | ||
|
|
||
| == Layout β the trident shape | ||
|
|
||
| Each verb lives in its own directory as a complete *trident* plus a | ||
| coherence manifest: | ||
|
|
||
| * `<Verb>file.a2ml` β the project-specific *declaration* (data: the | ||
| actual invariants / trust actions / tolerances / intents). | ||
| * `<verb>.ncl` β the paired Nickel *runner* (pedigree + schema + run | ||
| policy). Imports `../_base.ncl`. | ||
| * `<verb>.k9.ncl` β the *K9 trust-tier component* (execution surface, | ||
| evidence sinks, session-open/close negotiation). Imports the Hunt | ||
| base via `../k9/template-hunt.k9.ncl` and `../_base.ncl`. | ||
| * `<verb>.manifest.a2ml` β the *trident coherence manifest* (file roles, | ||
| cross-refs, signature, history). | ||
|
|
||
| Filenames use the lowercase verb in the `.ncl`/`.manifest` names and | ||
| noun-form PascalCase in the A2ML declaration (e.g. `intend.ncl` + | ||
| `Intentfile.a2ml`, `must.ncl` + `Mustfile.a2ml`). | ||
|
|
||
| `_base.ncl` provides the shared `pedigree_schema`, `run_defaults`, and | ||
| `probe_schema` that every runner merges into. `INDEX.a2ml` is the | ||
| machine-readable registry of all verbs β consumers should read it | ||
| rather than hard-coding the verb list. | ||
|
|
||
| == Verbs (6 + k9 exception) | ||
|
|
||
| [cols="1,2,3", options="header"] | ||
| |=== | ||
| | Verb | Declaration | Role (and gating) | ||
|
|
||
| | `must` | ||
| | `must/Mustfile.a2ml` | ||
| | Release-blocking physical-state invariants (LICENSE/README presence, | ||
| banned hardcoded paths, no Dockerfile/Makefile, β¦). *Gating* β | ||
| hard `exit-nonzero`. Specialises in subtle invariant-erosion. | ||
|
|
||
| | `trust` | ||
| | `trust/Trustfile.a2ml` | ||
| | Trust boundary, allowed/denied actions, provenance + supply-chain | ||
| integrity, dispatcher-trust (`T###` namespace). *Gating* β hard | ||
| `exit-nonzero`. Primary defence against unsound proofs leaving the | ||
| dispatcher. | ||
|
|
||
| | `adjust` | ||
| | `adjust/Adjustfile.a2ml` | ||
| | Drift tolerances + corrective actions; deterministic auto-fix where | ||
| declared. Advisory (`continue-with-warnings`), Yard tier. | ||
|
|
||
| | `dust` | ||
| | `dust/Dustfile.a2ml` | ||
| | Fine-grained recovery / rollback / deprecation with audit-trail | ||
| preservation (`D###` namespace). Destructive actions are dry-run by | ||
| default and require `--apply` + per-item approval. Advisory. | ||
|
|
||
| | `bust` | ||
| | `bust/Bustfile.a2ml` | ||
| | Breakage / expiry / hard-stop β declares "this is broken / must-not-run" | ||
| (e.g. deprecated paths that still exist). *Gating* β hard `exit-nonzero`. | ||
|
|
||
| | `intend` | ||
| | `intend/Intentfile.a2ml` | ||
| | North-star: committed next-actions (`[[intents]]`, with probes) AND | ||
| horizon aspirations (`[[wishes]]`, near/mid/far, no probes). | ||
| Non-gating (report only). Absorbed the deprecated `lust` verb | ||
| 2026-04-18. | ||
| |=== | ||
|
|
||
| NOTE: The `lust` verb was deprecated 2026-04-18 (name had unwanted | ||
| associations); its `[[wishes]]` semantics now live inside | ||
| `intend/Intentfile.a2ml` as a second section alongside `[[intents]]`. | ||
| Any `lust/` directory is drift and should be removed. | ||
|
|
||
| == Intentfile: commitments vs aspirations β two sections, one file | ||
|
|
||
| * `[[intents]]` is the *commitment axis*: tracked next-actions with | ||
| observable probes. Status progresses | ||
| `declared β in_progress β done / deferred / retired`. | ||
| * `[[wishes]]` is the *aspiration axis*: horizon goals grouped | ||
| near/mid/far, no probes. Status progresses | ||
| `declared β in_progress β achieved / abandoned`. | ||
|
|
||
| If something is concrete enough to have a probe, it is an intent; a | ||
| horizon-level desire that might never be acted on is a wish. A wish can | ||
| graduate into an intent when a concrete plan materialises. Intent is | ||
| guidance, never evidence of completion. | ||
|
|
||
| == k9 β service-automation layer (EXCEPTION to the one-verbfile rule) | ||
|
|
||
| `k9` is *not* a contractile verb and deliberately does not follow the | ||
| `<Verb>file.a2ml` + `<verb>.ncl` pattern. It is the graded automation | ||
| surface (three trust tiers) that validates or enforces the verb | ||
| declarations: | ||
|
|
||
| * *Kennel* β pure data; no subprocess, filesystem write, or network. | ||
| * *Yard* β Nickel evaluation with contracts/validation; no side effects. | ||
| * *Hunt* β full execution surface; must declare side effects, support | ||
| dry-run, and be signed before being trusted. | ||
|
|
||
| Each per-verb `<verb>.k9.ncl` declares a `paired_xfile` pointing at its | ||
| contractile (e.g. `../must/Mustfile.a2ml`); a floating k9 component with | ||
| no paired xfile is non-conformant. | ||
|
|
||
| [NOTE] | ||
| ==== | ||
| *Local k9-base status.* Echidna's three trust-tier templates currently | ||
| live under `../svc/k9/` (`template-kennel.k9.ncl`, `template-yard.k9.ncl`, | ||
| `template-hunt.k9.ncl`). The per-verb `<verb>.k9.ncl` components import the | ||
| canonical `../k9/template-hunt.k9.ncl` base path used estate-wide; that | ||
| shared Hunt base is a known estate-level gap (the same import is unresolved | ||
| in `standards`) and is tracked by the machine-readable respec programme | ||
| rather than patched per-repo here. The runner `.ncl` files (which import | ||
| only `_base.ncl`) `nickel typecheck` clean. | ||
| ==== | ||
|
|
||
| == Fill-in / maintenance rules | ||
|
|
||
| . Every declaration must hold real, project-specific content β no | ||
| generic samples, no `rsr-template` residue. | ||
| . `Mustfile` must encode invariants the toolchain can actually check. | ||
| . `Trustfile` must name the real keys, policies, and authority | ||
| boundaries. Per estate policy, licence/SPDX findings are *flag-only* | ||
| here β never auto-edited. | ||
| . `Dustfile` must describe real rollback/deprecation behaviour and what | ||
| evidence persists after a rollback. | ||
| . `Bustfile` must declare real breakage / expiry / hard-stop conditions. | ||
| . `Intentfile` must separate probed `[[intents]]` from horizon | ||
| `[[wishes]]`. | ||
| . Pair each `k9/*.k9.ncl` to a specific contractile via `paired_xfile`. |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.