You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: src/docs/Modules/Repository-Defaults.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -141,30 +141,30 @@ These files are the agent equivalent of the README: pointers, not copies. Keep t
141
141
142
142
## Managed file distribution
143
143
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.
145
147
146
148
Managed-file distribution follows this contract:
147
149
148
150
-`Type` maps a repository to its file-set root (for example `Module` or `Action`).
149
151
-`SubscribeTo` declares which optional managed file sets the repository receives.
150
152
- 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.
153
155
- Removing a file from a file set does not implicitly delete previously synced copies; deletion is an explicit managed change.
154
156
155
-
This page defines what files must exist in repositories. Distributor defines how those files are distributed and kept aligned.
156
-
157
157
### Migration for existing repositories
158
158
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:
160
160
161
161
1. Set or correct repository `Type` and `SubscribeTo` properties.
162
162
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.
165
165
5. Remove unmanaged duplicates or stale files explicitly when they are no longer part of an active file set.
166
166
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.
0 commit comments