SSPACEAGEDOCUMENTATION/
Release and Assurance

SpaceAge Release-Candidate Staging Manifest

Updated Aug 27, 2026   |   5.4 KB   |   docs/Release_Candidate_Staging_Manifest.md

SpaceAge Release-Candidate Staging Manifest

This manifest defines the intended source-controlled candidate. It exists to prevent broad git add -A staging from mixing product code with generated reports, build products, or one-off repair helpers.

Required Product And Test Files

  • .gitattributes
  • .gitignore
  • CMakeLists.txt
  • README.md
  • Source/PluginEditor.cpp
  • Source/PluginEditor.h
  • Source/PluginProcessor.cpp
  • Source/PluginProcessor.h
  • Source/PluginProcessorMidiCompat.cpp
  • Source/SpaceAgeMidi.cpp
  • Source/SpaceAgeMidi.h
  • Source/SpaceAgeProjectArchive.cpp
  • Source/SpaceAgeProjectArchive.h
  • Source/TempoCalc.cpp
  • Source/TempoCalc.h
  • Source/TG55Engine.cpp
  • Source/TG55Engine.h
  • Source/TG55FactoryBank.cpp
  • Source/TG55FactoryBank.h
  • Source/TG55PatchFormat.cpp
  • Source/TG55PatchFormat.h
  • Source/SpectralProcessor.cpp
  • Source/SpectralProcessor.h
  • Source/ThirdParty/TinySoundFont/tsf.h
  • Tests/AudioSelfTest.cpp
  • Tests/TG55EngineTest.cpp

Required Product Resources And Notices

  • Resources/splash.png
  • Resources/about.png
  • Resources/Inter-VariableFont_opsz,wght.ttf
  • Resources/OFL.txt
  • Resources/TinySoundFont-MIT.txt
  • Resources/ReleaseAssetClearance.json
  • Resources/DependencyLicenseManifest.json
  • Resources/FactoryPresetInventory.json
  • Resources/JuceSourceFingerprint.json
  • Resources/ReleaseHumanEvidencePlan.json
  • Every notice under Resources/Licenses/
  • Resources/TG55/catalog.json
  • All nine WAV files currently declared under Resources/TG55/ in CMakeLists.txt
  • All nine matching TG55 recipe JSON files
  • docs/Third_Party_Code_And_Licenses.md
  • docs/TG55_Asset_Provenance.md
  • docs/First_Party_Asset_Provenance.md
  • docs/Factory_Preset_Provenance.md
  • docs/Release_Legal_Signoff.md
  • docs/Release_Archive_Attestation.md

The TG55 recipe JSON sidecars are factory-source provenance, not runtime inputs. Track them with their WAVs. The assets remain blocked from public distribution until the provenance requirement in docs/TG55_Asset_Provenance.md is resolved.

Required Release Tools

  • tools/spaceage_paths.ps1
  • tools/build_release.ps1
  • tools/run_tests.ps1
  • tools/package_release.ps1
  • tools/codex-build-selftest.ps1
  • tools/run-midi-closeout-fast.ps1
  • tools/run-release-convergence.ps1
  • tools/test-clean-checkout-convergence.ps1
  • tools/test-clean-checkout-receipt.ps1
  • tools/test-release-hygiene.ps1
  • tools/test-release-asset-clearance.ps1
  • tools/test-release-legal-signoff.ps1
  • tools/test-release-readiness-ledger.ps1
  • tools/test-release-human-evidence-plan.ps1
  • tools/test-release-resource-privacy.ps1
  • tools/test-release-binary-identity.ps1
  • tools/test-release-runtime-imports.ps1
  • tools/test-release-juce-source.ps1
  • tools/verify-juce-source-against-upstream.ps1
  • tools/test-release-archive.ps1
  • tools/test-release-archive-contract.ps1
  • tools/test-release-archive-attestation.ps1
  • tools/test-standalone-launch.ps1
  • tools/get-release-candidate-status.ps1
  • tools/compare-release-candidates.ps1

Candidate Documentation

Stage implemented-behavior and governance documents deliberately, including:

  • docs/Answers_for_Shane.md
  • docs/Beta_Roadblocks_Report.md
  • docs/Build_Test_Package_Workflow.md
  • docs/Code_Commenting_Architecture_Guide.md
  • docs/Creative_Thinking.md
  • docs/Human_Beta_QA_Matrix.md
  • docs/Internal_Instrument_Audit.md
  • docs/Lane_Owned_Instrument_Migration.md
  • docs/MIDI_Architecture.md
  • docs/MIDI_Implementation_Status.md
  • docs/MIDI_UI_Workflow_Spec.md
  • docs/Packaging_And_Identity_Audit.md
  • docs/Product_Glossary.md
  • docs/Project_Gotchas_Checklist.md
  • docs/Release_Readiness_Checklist.md
  • docs/Shortcut_Cheat_Sheet.md
  • docs/SpaceAge_Feature_Outline.md
  • docs/UI_Text_Clipping_Audit.md
  • docs/Whiteboard.md
  • docs/Yamaha_XG_Editor_Spec.md
  • docs/Yamaha_XG_QY_Parameter_Table_Preview_Example.json
  • docs/Arrangement_Record_Button_Plan.md
  • docs/Development_Process_Time_Savings_Report.md
  • docs/Feature_Backlog_And_Maybe_Ideas.md
  • docs/Manual_Device_Reference_Notes.md
  • docs/MIDI_Progress_Report.md
  • docs/Ports.md

Roadmaps, process retrospectives, future port plans, and manual research notes are not build dependencies, but are tracked deliberately because they preserve product intent and maintenance context.

Never Stage

  • build-* directories
  • reports/, test-reports/, and outputs/
  • Root *.out and *.err receipts
  • _fix_clock_label.py
  • _fix_midi_compat.py
  • _midi_compat_append.txt
  • midi-unresolved.txt
  • tools/append_midi_compat_ext.py

Release Proof Sequence

  1. Resolve the TG55 factory-asset provenance release blocker.
  2. Stage only the reviewed manifest, never git add -A.
  3. Review the staged diff and verify no generated evidence entered the index.
  4. Create one intentional release-candidate commit.
  5. Run tools/test-clean-checkout-convergence.ps1 -CandidateSha <SHA>.
  6. Run public packaging; preserve the ZIP, checksum sidecar, generated archive attestation, source commit, toolchain evidence, and exact-SHA receipt together.
  7. Complete the generated archive attestation for that exact ZIP and run tools/test-release-archive-attestation.ps1.
  8. Complete physical MIDI, listening, clean-machine, host, and installer QA.

No candidate is certified until the clean-checkout gate passes from the exact committed SHA.