seedling
snug seedling <COMMAND>Seedling - Deterministic generation, minting, and provenance.
Subcommands
| Command | What it does |
|---|---|
generators | Generator definition management |
generate | Execute a single deterministic generation |
permalink | Fetch a generation by its shareable permalink form |
generate-batch | Generate a batch of outputs |
daily | Get the canonical daily seed for a generator |
verify-determinism | Golden determinism check: confirm (generator, version, seed) reproduces identical output |
seeds | Named seed registry |
series | Series (edition) management |
mint | Mint an artifact from a series |
records | Lineage record management |
history | Show full artifact history |
owned | List artifacts owned by a principal |
derived | List artifacts derived from an artifact |
track | Place an external object under custody tracking |
Run snug seedling <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug seedling generators create --name "Cavern Dungeon" --type bsp-rooms
snug seedling generators create --name "Bard Lines" --type grammar --grammar '{"start":"line","rules":{"line":[{"text":"Hail!"}]}}'
snug seedling generators publish --generator-id 0199e72a-4000-7000-8000-000000000006 --version 2
snug seedling generators version --generator-id 0199e72a-4000-7000-8000-000000000006 --version 2
snug seedling generators list --filter 'generator_type[eq]=grid_map'
snug seedling generators get --generator-id 0199e72a-4000-7000-8000-000000000006
snug seedling generate --generator-id gen_names_norse --seed glacier-fox-9421 --param style=norse --param count=10
snug seedling verify-determinism --generator-id 0199e72a-4000-7000-8000-000000000006 --version 2 --seed glacier-fox-9421
snug seedling permalink --generator-id 0199e72a-4000-7000-8000-000000000006 --version 2 --seed glacier-fox-9421
snug seedling generate-batch --generator-id 0199e72a-4000-7000-8000-000000000008 --base-seed daily --count 100
snug seedling daily --generator-id gen_cavern_dungeon
snug seedling seeds publish --generator-id 0199e72a-4000-7000-8000-00000000000c --version 3 --seed glacier-fox-9421 --name "Glacier Fox" --tags islands,hard
snug seedling seeds list --featured-only
snug seedling seeds feature --seed-id 0199e72a-4000-7000-8000-00000000000f
snug seedling series create --domain kingdoms --name "Sunforged Sword" --max-supply 500 --per-user-limit 1 --serials sequential
snug seedling series get --domain kingdoms --series-id 0199e72a-4000-7000-8000-000000000013
snug seedling mint --domain kingdoms --series-id 0199e72a-4000-7000-8000-000000000013 --idempotency-key key1 --for-id usr_01J9ABCD
snug seedling records append --domain kingdoms --artifact-id 0199e72a-4000-7000-8000-000000000002 --kind transfer --to-id usr_bob --ref handshake:deal_1
snug seedling history --domain kingdoms --artifact-id 0199e72a-4000-7000-8000-000000000002 --verify chain
snug seedling owned --domain kingdoms --principal usr_01J9ABCD --ever --filter 'status[eq]=active'
snug seedling derived --domain kingdoms --artifact-id 0199e72a-4000-7000-8000-000000000002 --depth 3
snug seedling track --domain supply_chain --service erp --external-id pallet_8841Next
- seedling guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.