Skip to content

Docs: elemod source fingerprint, package exporter and Rytm queued trigs - #1420

Merged
npp1993 merged 1 commit into
repeat98:mainfrom
npp1993:claude/docs-elemod-source-record
Nov 11, 2026
Merged

npp1993 merged 1 commit into
repeat98:mainfrom
npp1993:claude/docs-elemod-source-record

Conversation

@npp1993

@npp1993 npp1993 commented Nov 11, 2026

Copy link
Copy Markdown
Collaborator
  • What was wrong or hard: three things nothing in the guides said, met while building Improved AMP (Improved AMP 0.1.0-experimental (Analog Rytm MKII, OS 1.74) #1419). A documentation edit in a module folder changes the build's source fingerprint, so an import record's runtimeSourceSha256 goes out of date although the exported package is the same file. scripts/package-elemod-recipe.mjs stops with EEXIST when the package is already there, which reads like a failure of the rebuild. And nothing told a Rytm module author how OS 1.74 queues trigs: a module that looks ahead at a track's next trig and reads one slot misses swung and micro-timed trigs.
  • What this changes: docs/ELEMOD_SOURCE_BUILDS.md ("Source-only release objects") says the exporter never overwrites and that --check confirms an unchanged export, and that the fingerprint hashes every file in the module folder, documents included, with what to do about the import record. sdk/machines/analog-rytm-mkii/README.md gains "Queued trigs: looking ahead": three event slots a track, one event a track a block, what is queued but not played, which sound a queued trig will play, and that retrigs are not queued. Addresses only, no stock code.
  • How I checked it: npm run pr:ready says Ready (the documentation check passes). The fingerprint's inventory is inventory in scripts/build-elemod-packages.mjs; no script reads runtimeSourceSha256 (git grep). The queue facts are the ones Improved AMP's src/pre-fade.c was written from and its TESTING.md records in rytm-emu and on a unit.
  • What the guides lacked or got wrong, and where I fixed it: the three points above, in the two files named.

🤖 Generated with Claude Code

The source fingerprint covers a module's documents, the exporter refuses to
overwrite a package, and OS 1.74 queues a track's trigs in three event slots,
one event a track a block.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Nov 11, 2026
@npp1993
npp1993 enabled auto-merge (squash) November 11, 2026 01:38
@npp1993
npp1993 merged commit be33082 into repeat98:main Nov 11, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant