Add cross-repo Rsms engine map and fix drifted PangaeaAppliance citations#84
Merged
MichaelThompson merged 3 commits intoJun 22, 2026
Merged
Conversation
Document that custom-platform scripts authored here are executed by the Rsms scriptable engine in Kevin-Andrew/PangaeaAppliance, and map every authored construct (operations, Do-block verbs, parameter types, reserved variables, task-log/status contracts, validation entry points) to the authoritative source file:line in that repo. - Add docs/agent-reference/rsms-engine-map.md (source-cited engine map) - Add 'Cross-repo: the Rsms execution engine' section to AGENTS.md - Index the new doc in docs/agent-reference/README.md - Correct stale Hercules\\Source\\* citations (the subtree was relocated under src\\) in tools/README.md and the task-log-analysis and safeguard-ps-operations skills Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Record snapshot commit fb5ae4e0fe1bc438c8035dbe9b7086b77b40115b as the verifiable whole-tree ref (9be615a13d was only the last commit touching the Scriptable engine dir), and note that the log-name constants in Common.Rsms\\Rsms.Public\\Constants\\Logging.cs are the single canonical definition. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The shadow-entry hash-check logic moved with the Hercules->src\ relocation: Source\Hercules.WebService\Common\Crypt\PasswordHash.cs is now src\Service\Rsms\Common\Crypt\PasswordHash.cs:96 (CheckPasswordAgainstShadowEntry, splits the shadow line on ':' at :98). Update the failure-patterns row and add the helper location to the engine map. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
Why
The custom-platform JSON authored in this repo is executed by the Rsms scriptable engine, whose source lives in a separate repository,
Kevin-Andrew/PangaeaAppliance. Several contracts this repo depends on (task-log shape, status enum, log-name constants, secret-redaction sentinel) are defined there. Agents fixing compatibility bugs between the two repos had no authoritative map of where those engine contracts live — and several existing citations had silently gone stale after the engine'sHercules\Source\*tree was relocated undersrc\.What
docs/agent-reference/rsms-engine-map.md— a source-cited map from each authored construct (operations,Do-block verbs incl. lesser-known ones, the two parameter-type enums, reserved variables,TaskLog/TaskStatuscontracts, validation entry points) → the authoritative PangaeaAppliancefile:line. Pinned to a verifiable snapshot ref. Highlights real compat gaps (e.g.DiscoverApiKeys/CheckHostKeyare enum values with no executable impl) and flags the validation section as the top place to hunt "schema accepts / engine rejects" bugs.AGENTS.md— new "Cross-repo: the Rsms execution engine" section establishing that the engine is authoritative and the localschema/is a drift-prone mirror.docs/agent-reference/README.md— indexes the new doc.Hercules\Source\*engine citations to their currentsrc\...paths intools/README.md,.agents/skills/task-log-analysis/SKILL.md,.agents/skills/safeguard-ps-operations/SKILL.md, anddocs/agent-reference/failure-patterns.md(thePasswordHash/CheckPasswordAgainstShadowEntryreference).A reciprocal back-pointer was also added on the PangaeaAppliance side (a README in the Scriptable engine directory pointing back here) so that future engine contract changes prompt a heads-up to this repo.
Provenance
The engine-map citations come from a source-cited analysis of the PangaeaAppliance tree at commit
fb5ae4e0fe1bc438c8035dbe9b7086b77b40115b. All relative links validated bytools/Test-AgentLinks.ps1(13 files, all resolve).