Skip to content

Commit 9d03549

Browse files
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>
1 parent 8f9ac2e commit 9d03549

1 file changed

Lines changed: 7 additions & 18 deletions

File tree

src/docs/Modules/Repository-Defaults.md

Lines changed: 7 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -141,30 +141,19 @@ 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 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).
145145

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:
147147

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.
156151

157152
### Migration for existing repositories
158153

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.
166155

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.
168157

169158
## Supply-chain defaults
170159

0 commit comments

Comments
 (0)