All notable changes to Seeds will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.2.5 - 2026-03-04
sd block <id> --by <blocker-id>command — mark an issue as blocked by anothersd unblock <id> --from <blocker-id>command — remove a specific blocker (--allto clear all)sd labelsubcommand group —add,remove,list,list-allfor issue labels- Labels field on issues — optional
string[]for categorization and filtering sd list --label <label>filter — list issues by label--allflag onsd list— show all issues including closed (default now filters to open/in_progress)
sd listnow defaults to showing only open and in_progress issues (use--allfor previous behavior)
0.2.4 - 2026-02-25
sd completions <shell>command — output shell completion scripts for bash, zsh, and fish--timingglobal flag — show command execution time on stderr- Typo suggestion tests for misspelled command names
- Tests for
--timingflag and shell completions
sd initnow derives project name from directory name instead of hardcoding "seeds"
0.2.3 - 2026-02-24
- Worktree root resolution —
findSeedsDir()resolves to the main repo's.seeds/when running inside a git worktree isInsideWorktree()helper inconfig.tsfor worktree detection- Worktree guard in
sd sync— skips commit with warning when running from a worktree (supports--json) - Tests for worktree resolution (
config.test.ts) and sync worktree guard (sync.test.ts) - Custom branded help formatting for
sd --help— colored commands, aligned options, branded header
- Lock retry interval increased from 50ms to 100ms with random jitter to reduce contention
- Lock timeout increased from 5s to 30s for better multi-agent reliability
0.2.2 - 2026-02-24
sd upgradecommand — check for and install latest version from npm (--checkfor version check only)--quiet/-qglobal flag — suppress non-error output--verboseglobal flag — extra diagnostic output--dry-runflag onsd sync— preview what would be committed without committingprintWarning()helper inoutput.ts
- Applied os-eco forest branding palette:
brand(green),accent(amber),muted(gray) replace raw chalk colors across all commands - Status icons updated to ASCII-safe set:
✓(pass),!(warn),✗(fail),>(in-progress),-(open),x(closed) - Version flag changed from
-Vto-v(standard convention) --version --jsonnow returns structured{name, version, runtime, platform}object- npm publish workflow: switched from
--provenanceto token-based auth viaNPM_TOKENsecret
0.2.1 - 2026-02-24
- Migrated CLI parsing from manual switch/case to Commander.js — proper subcommands, built-in help, and option validation
- Replaced manual ANSI escape codes with chalk for output formatting
- Use
process.exitCode = 1instead ofprocess.exit(1)for graceful shutdown - Replaced auto-tag workflow with unified publish workflow for npm
--descflag silently dropped descriptions increateandupdatecommands
- chalk and commander as runtime dependencies
--descas explicit alias for--descriptionincreateandupdate
.beads/directory — seeds is now the sole issue tracker- Manual ANSI color helpers (
c.red,c.green, etc.) inoutput.ts
0.2.0 - 2026-02-23
sd doctorcommand — validates project health: config, JSONL integrity, field validation, dependency consistency, stale locks, gitattributes, and.gitignore. Supports--fixfor auto-fixable issuessd primecommand — outputs AI agent context (PRIME.md or built-in reference). Supports--compactfor condensed outputsd onboardcommand — adds seeds section to CLAUDE.md/AGENTS.md with marker-delimited sections for idempotent updatessrc/markers.tsutility for marker-delimited section management (used byonboard)- CODEOWNERS file for branch protection
0.1.0 - 2026-02-23
- Initial release
- Issue CRUD:
sd create,sd show,sd list,sd update,sd close - Dependency tracking:
sd dep add/remove/list,sd blocked,sd ready - Templates/molecules:
sd tpl create/step/list/show/pour/status - Advisory file locking for concurrent multi-agent access
- Atomic writes (temp file + rename) with dedup-on-read
- YAML config (
config.yaml), JSONL storage (issues.jsonl,templates.jsonl) --jsonflag on all commands for structured output- Migration from beads:
sd migrate-from-beads sd syncto stage and commit.seeds/changessd statsfor project statistics- Zero runtime dependencies — Bun built-ins only
merge=uniongitattribute for git-native parallel branch merges