agents/bundles: file: source defaults to destination basename
Caught during the left4me-integration nginx 80.conf move: the agent declared a redundant 'source': '80.conf' on a file: item whose destination already ended in 80.conf. The maintainer flagged it as noise. Document the rule: only declare source when the basename differs from the destination (e.g. .mako template to a non-suffixed destination). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
0e88c4967e
commit
7a579f27c5
1 changed files with 6 additions and 0 deletions
|
|
@ -102,6 +102,12 @@ bundles/<name>/
|
|||
unless the matching `file:` item declares `content_type='mako'`
|
||||
(or a templating extension triggers it). To check, read the matching
|
||||
`file:` entry in `items.py`.
|
||||
- **`file:` `source` defaults to the destination basename.** For a
|
||||
destination of `/etc/foo/bar.conf` with no `source` key, bw looks
|
||||
for `bundles/<bundle>/files/bar.conf`. Only declare `source`
|
||||
explicitly when the basename you want differs (e.g. shipping a Mako
|
||||
template named `bar.conf.mako` to a destination of
|
||||
`/etc/foo/bar.conf`).
|
||||
- **Reactors writing across namespaces.** Some bundles' reactors write
|
||||
into other bundles' metadata namespaces (e.g. `nextcloud` writes
|
||||
into `apt.packages`, `archive.paths`). When you change such a bundle,
|
||||
|
|
|
|||
Loading…
Reference in a new issue