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: keep repository defaults focused on what, delegate how to Custo
Refocus managed-file section to define required repository state in
PSModule/docs and move runtime implementation details to MSXOrg/Custo.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copy file name to clipboardExpand all lines: src/docs/Modules/Repository-Defaults.md
+7-18Lines changed: 7 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -141,30 +141,19 @@ 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 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.
144
+
**Policy ownership and distribution runtime are separate concerns.** This page — and this repository (`PSModule/docs`) — defines *what* files must exist in module repositories and *what standards they must meet*. The distribution runtime is handled by [`MSXOrg/Custo`](https://github.com/MSXOrg/Custo).
145
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.
146
+
For PSModule module repositories, the requirements are:
147
147
148
-
Managed-file distribution follows this contract:
149
-
150
-
-`Type` maps a repository to its file-set root (for example `Module` or `Action`).
151
-
-`SubscribeTo` declares which optional managed file sets the repository receives.
152
-
- Organization-wide mandatory file sets define non-optional governance and supply-chain files for each applicable repository type.
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.
155
-
- Removing a file from a file set does not implicitly delete previously synced copies; deletion is an explicit managed change.
148
+
- Repositories must contain the required baseline files defined on this page.
149
+
- Managed copies of those files are treated as generated distribution artifacts, not repository-specific source.
150
+
- Standard changes to managed-file content are made in the distribution engine, not by patching generated copies in receiving repositories.
156
151
157
152
### Migration for existing repositories
158
153
159
-
Repositories still aligned to `PSModule/Distributor` (the previous distribution engine) or older distribution behavior should be migrated to Custo:
160
-
161
-
1. Set or correct repository `Type` and `SubscribeTo` properties.
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 Custo source file sets.
164
-
4. Sync from Custo and merge the `managed-files/update` pull request.
165
-
5. Remove unmanaged duplicates or stale files explicitly when they are no longer part of an active file set.
154
+
Repositories still aligned to `PSModule/Distributor` (the previous distribution engine) should migrate to Custo as the runtime implementation.
166
155
167
-
After migration, the repository keeps the required files from this standard, and managed-file content changes are made through Custo-first updates.
156
+
This page defines the required target state (the file requirements). Runtime migration mechanics and rollout design (repository targeting, update flow, overwrite behavior, and deletion behavior) are owned by Custo and should be documented and executed from the Custo repository.
0 commit comments