📝 Document the unified seed engine and retire the vault page#173
Merged
Conversation
- tools/seed.md: full rewrite for the ws-cli seed engine — version:v1 dest-keyed manifest, two tiers (bare mirror + behavior overlay), ops (copy/merge/append/prepend), templating, inline + whole-file secrets, ownership boundary, force/ephemerality, apply/ls. Documents the accepted caveats (non-idempotent append/prepend, JSON large-int precision, keep ciphertext outside the mirror, re-author for key rotation). - settings/vault.md: tombstone — the vault is removed (no migrate); redirect to the seed manifest + secrets primitives. Drop the sidebar entry. - tools/ws-cli.md: drop vault from secrets, add a `ws seed` section. - settings/secrets.md, settings/tls.md, editor/storage.md: repoint dead /settings/vault links and the killed "vault" term to /tools/seed.
Document the new `op: block` managed-marker-block operation and its `comment:` prefix, and correct the append/prepend behaviour to write-if-absent. Move the guide from `tools/` to `settings/` (seed is a configuration feature, not an installed tool) and give it a `seed.svg` hero icon. Delete the vault page outright (no tombstone), de-vault the secrets icon, and repoint every inbound link. Rewrite developer-facing phrasing for the end-user audience and trim duplicated explanations.
Add the `op: lineinfile` operation and a `seed rotate` section, and drop the JSON large-integer precision caveat now that merge preserves them.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
ws-docs side of q2-59 (unified
ws-cli seedengine). Rides the env.reference distribute cycle for theseed.sourceslug.Changes
settings/seed.md(relocated fromtools/— seed is a configuration feature, not an installed tool; joinsautoload-scripts/secrets). Documents the manifest, two tiers, all operations incl. the newop: blockmanaged marker block and itscomment:prefix, templating, secrets, the ownership boundary, and force/ephemerality.seed.svghero icon.settings/vault.mdoutright (no tombstone) and de-vaulted the secrets icon (vault.svg→secrets.svg)./tools/seed→/settings/seed(storage.md,ws-cli.md,secrets.md,tls.md) and moved the sidebar entry Tools → Settings.os.Root,st_uid == geteuid(),float64, "single resolved plan") and trimmed duplicated explanations.Companion
workspaceenv.reference.yamlupdates theseed.sourcereference:slug to/settings/seedso the auto-generated env page links here after distribute.