Skip to content

Commit 8f9ac2e

Browse files
docs: migrate managed-file distribution from Distributor to Custo
Replace PSModule/Distributor references with MSXOrg/Custo as the distribution runtime in Repository-Defaults.md. - Clarify that PSModule/docs remains policy/source-of-truth - Custo is the cross-initiative distribution engine at runtime - Preserve all behavioral semantics: managed-files/update branch, PR naming convention, overwrite behavior, explicit delete semantics - Expand migration note to cover Distributor -> Custo transition Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent 3908862 commit 8f9ac2e

1 file changed

Lines changed: 9 additions & 9 deletions

File tree

src/docs/Modules/Repository-Defaults.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -141,30 +141,30 @@ These files are the agent equivalent of the README: pointers, not copies. Keep t
141141

142142
## Managed file distribution
143143

144-
Shared repository files are managed through [`PSModule/Distributor`](https://github.com/PSModule/Distributor). Distributor is the source of truth for managed file content and file-set membership.
144+
Shared repository files are distributed through [`MSXOrg/Custo`](https://github.com/MSXOrg/Custo), the central managed-file distribution and compliance orchestration engine for MSX initiatives. Custo is the runtime responsible for keeping managed file content aligned across repositories.
145+
146+
**Policy ownership and distribution runtime are separate concerns.** This page — and this repository (`PSModule/docs`) — defines *what* files must exist and *what standards they must meet*. Custo defines *how* those files are distributed and kept aligned at runtime.
145147

146148
Managed-file distribution follows this contract:
147149

148150
- `Type` maps a repository to its file-set root (for example `Module` or `Action`).
149151
- `SubscribeTo` declares which optional managed file sets the repository receives.
150152
- Organization-wide mandatory file sets define non-optional governance and supply-chain files for each applicable repository type.
151-
- Distributor delivers changes through a `managed-files/update` branch and a `⚙️ [Maintenance]: Sync managed files` pull request.
152-
- Receiving repositories treat managed files as generated artifacts from Distributor. Local edits in the receiving repository are replaced on the next sync and must be made in Distributor instead.
153+
- Custo delivers changes through a `managed-files/update` branch and a `⚙️ [Maintenance]: Sync managed files` pull request.
154+
- Receiving repositories treat managed files as generated artifacts from Custo. Local edits in the receiving repository are replaced on the next sync; content changes must be made in Custo instead.
153155
- Removing a file from a file set does not implicitly delete previously synced copies; deletion is an explicit managed change.
154156

155-
This page defines what files must exist in repositories. Distributor defines how those files are distributed and kept aligned.
156-
157157
### Migration for existing repositories
158158

159-
Repositories that still reflect older distribution behavior should be aligned to this contract:
159+
Repositories still aligned to `PSModule/Distributor` (the previous distribution engine) or older distribution behavior should be migrated to Custo:
160160

161161
1. Set or correct repository `Type` and `SubscribeTo` properties.
162162
2. Ensure mandatory governance and supply-chain files from this standard exist in the repository.
163-
3. Move any intended local edits in managed files into Distributor source file sets.
164-
4. Sync from Distributor and merge the `managed-files/update` pull request.
163+
3. Move any intended local edits in managed files into Custo source file sets.
164+
4. Sync from Custo and merge the `managed-files/update` pull request.
165165
5. Remove unmanaged duplicates or stale files explicitly when they are no longer part of an active file set.
166166

167-
After migration, the repository keeps the required files from this standard, and managed-file content changes are made through Distributor-first updates.
167+
After migration, the repository keeps the required files from this standard, and managed-file content changes are made through Custo-first updates.
168168

169169
## Supply-chain defaults
170170

0 commit comments

Comments
 (0)