Skip to content

docs: give SONIFICATION a research banner, DOI gallery and CI dashboard - #49

Merged
EmergentMonk merged 3 commits into
mainfrom
docs/readme-research-banner-doi-badges-20261110
Nov 10, 2026
Merged

EmergentMonk merged 3 commits into
mainfrom
docs/readme-research-banner-doi-badges-20261110

Conversation

@EmergentMonk

@EmergentMonk EmergentMonk commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

Summary

Refresh the public SONIFICATION landing page without touching research source, frozen evidence, tags or release assets.

  • Add a centered, self-contained 1440×450 SVG research banner (docs/assets/sonification-banner.svg) with geometric/spectral artwork and no remote assets, external fonts or scripts.
  • Add eight linked version-specific Zenodo DOI badges (ETQ, D4-TIA, MAT-SPEC, SPARK-001, SONIFICATION-FORMAL-001).
  • Add six live GitHub Actions badges for project tests, native Ada/Python differential workflows, and read-only historical proof-receipt integrity checks. The owner-only GNATprove workflow is deliberately not depicted as automatic CI proof.
  • Add a research-track overview, scoped verification table, reproducibility commands, scientific limits, current formalization DOI/source identity, and published DOI catalogue.
  • Preserve the detailed MAT-SPEC-001–010, ETQ-303, D4-TIA, runtime-artifact and scientific-boundary documentation below.
  • Repair escaped inline Markdown backticks in existing README examples.

Exact release and research boundaries

  • Formal research milestone: sonification-formal-001-research.1
  • Published DOI: 10.5281/zenodo.24097287
  • Frozen source: ef2851fd44894dd95a4c3184ff9e41aeb4d64d72.
  • Retained SPARK owner receipts: 26/26, 23/23, and 9/9 over three separate, bounded and source-pinned proof runs.
  • MAT-010 Phase A accepted; Phases B/C, production Python refinement and independent physical admission remain OPEN.
  • No new physical theory or classifier accuracy is asserted. No MAT-SPEC-011.

Review / validation

  • README text integrity checked: existing numbered MAT-SPEC profiles, root policies and scientific-boundary sections remain present.
  • Confirmed eight DOI badges and six CI badge links against the actual repository workflow filenames.
  • README uses explicit centered HTML and accessible image alt text.
  • GitHub compare checked: README.md + one new SVG only.
  • No application tests or Lean/GNATprove execution claimed; documentation-only PR.

Owner review and approval requested. Do not merge automatically.

Summary by Sourcery

Refresh the SONIFICATION README as a traceable research landing page without changing research source, evidence, release assets, or formalization claims.

New Features:

  • Add a research-focused SONIFICATION landing page with a self-contained visual banner, versioned DOI gallery, live workflow badges, research-track overview, and reproducibility guidance.

Bug Fixes:

  • Correct escaped inline Markdown code formatting in existing README examples.

Enhancements:

  • Document verification scope, source-pinned formalization identity, assurance boundaries, scientific limitations, roadmap status, and published research records while preserving existing detailed documentation.

Documentation:

  • Expand README navigation and public-facing documentation with formal verification results, reproduction commands, scientific nonclaims, and a consolidated DOI catalogue.

@sourcery-ai

sourcery-ai Bot commented Nov 10, 2026

Copy link
Copy Markdown

Sorry @EmergentMonk, you've used your own review budget of 250,000 diff characters for the last 7 days.

You can request another review in 1 day and 4 hours by commenting @sourcery-ai review. Upgrade to get a review now.

@sourcery-ai

sourcery-ai Bot commented Nov 10, 2026

Copy link
Copy Markdown

Reviewer's Guide

UI

Add the self-contained geometric research banner used at the top of the landing page.

  • docs/assets/sonification-banner.svg L1-83

Documentation

Refresh the README landing page with release and CI badges, research and verification scope, reproduction guidance, scientific boundaries, and a DOI catalogue while preserving the detailed material-profile documentation.

  • README.md L1-94, L163-167, L552-572 (+4 small edits)

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-10T05:08:37.193909Z 7632ba0 Manual request
🔒 Security Review ✅ Completed 2026-11-10T05:08:12.669502Z 7632ba0 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@EmergentMonk

Copy link
Copy Markdown
Member Author

@codex Please Review this exact SHA 7632ba0 gainst the existing contract. Report only actionable correctness defects, with a minimal reproduction, expected versus actual behavior, and affected lines. State whether each reproduction was executed or statically inferred. Don’t repeat fixed findings without a new failing case. Keep architectural suggestions separate and non-blocking.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: 7632ba0ccd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@EmergentMonk
EmergentMonk merged commit 2ca65c6 into main Nov 10, 2026
13 checks passed
@EmergentMonk
EmergentMonk deleted the docs/readme-research-banner-doi-badges-20261110 branch November 10, 2026 05:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant