docs: add 0.31.0 changelog

This commit is contained in:
Steve Yegge
2025-12-20 16:59:09 -08:00
parent c7c212f8a1
commit 9d19115357
2 changed files with 76 additions and 0 deletions
+1
View File
@@ -276,6 +276,7 @@
{"id":"bd-u0g9","title":"GH#405: Prefix parsing with hyphens treats first segment as prefix","description":"Prefix me-py-toolkit gets parsed as just me- when detecting mismatches. Fix prefix parsing to handle multi-hyphen prefixes. See GitHub issue #405.","status":"tombstone","priority":2,"issue_type":"bug","created_at":"2025-12-16T01:03:18.354066-08:00","updated_at":"2025-12-17T16:11:17.070763-08:00","deleted_at":"2025-12-17T16:11:17.070763-08:00","deleted_by":"batch delete","delete_reason":"batch delete","original_type":"bug"}
{"id":"bd-umbf","title":"Design contributor namespace isolation for beads pollution prevention","description":"## Problem\n\nWhen contributors work on beads-the-project using beads-the-tool, their personal work-tracking issues leak into PRs. The .beads/issues.jsonl is intentionally tracked (it's the project's issue database), but contributors' local issues pollute the diff.\n\nThis is a recursion problem unique to self-hosting projects.\n\n## Possible Solutions to Explore\n\n1. **Contributor namespaces** - Each contributor gets a private prefix (e.g., `bd-steve-xxxx`) that's gitignored or filtered\n2. **Separate database** - Contributors use BEADS_DIR pointing elsewhere for personal tracking\n3. **Issue ownership/visibility flags** - Mark issues as \"local-only\" vs \"project\"\n4. **Prefix-based filtering** - Configure which prefixes are committed vs ignored\n\n## Design Considerations\n\n- Should be zero-friction for contributors (no manual setup)\n- Must not break existing workflows\n- Needs to work with sync/collaboration features\n- Consider: what if a \"personal\" issue graduates to \"project\" issue?\n\n## Expansion Needed\n\nThis is a placeholder. Needs detailed design exploration before implementation.","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-13T18:00:29.638743-08:00","updated_at":"2025-12-13T18:00:41.345673-08:00"}
{"id":"bd-uqfn","title":"Work on beads-wkt: Output control parameters for MCP tool...","description":"Work on beads-wkt: Output control parameters for MCP tools (GH#622). Add brief, fields, max_description_length params to ready/list/show. When done, submit MR (not PR) to integration branch for Refinery.","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-19T22:57:10.675535-08:00","updated_at":"2025-12-20T00:26:12.606293-08:00","closed_at":"2025-12-19T23:28:25.362931-08:00"}
{"id":"bd-usro","title":"Rename 'template instantiate' to 'mol bond'","description":"Rename the template instantiation command to match molecule metaphor.\n\nCurrent: bd template instantiate \u003cid\u003e --var key=value\nTarget: bd mol bond \u003cid\u003e --var key=value\n\nChanges needed:\n- Add 'mol' command group (or extend existing)\n- Add 'bond' subcommand that wraps template instantiate logic\n- Keep 'template instantiate' as deprecated alias for backward compat\n- Update help text and docs to use molecule terminology\n\nThe 'bond' verb captures:\n1. Chemistry metaphor (molecules bond to form structures)\n2. Dependency linking (child issues bonded in a DAG)\n3. Short and active\n\nSee also: molecule execution model in Gas Town","status":"open","priority":1,"issue_type":"feature","created_at":"2025-12-20T16:56:37.582795-08:00","updated_at":"2025-12-20T16:56:37.582795-08:00"}
{"id":"bd-uutv","title":"Work on beads-rs0: Namepool configuration for themed pole...","description":"Work on beads-rs0: Namepool configuration for themed polecat names. See bd show beads-rs0 for full details.","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-19T21:49:48.129778-08:00","updated_at":"2025-12-19T21:59:25.565894-08:00","closed_at":"2025-12-19T21:59:25.565894-08:00"}
{"id":"bd-vgi5","title":"Push version bump to GitHub","description":"git push origin main - triggers CI but no release yet.","status":"closed","priority":1,"issue_type":"task","created_at":"2025-12-18T22:43:05.363604-08:00","updated_at":"2025-12-18T22:46:57.50777-08:00","closed_at":"2025-12-18T22:46:57.50777-08:00","dependencies":[{"issue_id":"bd-vgi5","depends_on_id":"bd-qqc","type":"parent-child","created_at":"2025-12-18T22:43:16.87736-08:00","created_by":"daemon"},{"issue_id":"bd-vgi5","depends_on_id":"bd-3ggb","type":"blocks","created_at":"2025-12-18T22:43:21.078208-08:00","created_by":"daemon"}]}
{"id":"bd-vpan","title":"Re: Thread Test 2","description":"Got your message. Testing reply feature.","status":"tombstone","priority":2,"issue_type":"message","created_at":"2025-12-16T18:21:29.144352-08:00","updated_at":"2025-12-17T16:11:17.070763-08:00","dependencies":[{"issue_id":"bd-vpan","depends_on_id":"bd-x36g","type":"replies-to","created_at":"2025-12-18T13:45:31.137191-08:00","created_by":"migration"}],"deleted_at":"2025-12-17T16:11:17.070763-08:00","deleted_by":"batch delete","delete_reason":"batch delete","original_type":"message"}
+75
View File
@@ -7,6 +7,81 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [0.31.0] - 2025-12-20
### Added
- **`bd defer` / `bd undefer` commands** (bd-4jr) - New "deferred" status for icebox issues
- Issues that are deliberately postponed, not blocked by dependencies
- Deferred issues excluded from `bd ready` and shown with ❄️ snowflake styling
- Full support in MCP server, graph views, and statistics
- **Agent audit trail** (GH#649) - Append-only logging for AI agent interactions
- New `.beads/interactions.jsonl` audit file
- `bd audit record` - Log LLM calls, tool calls, or pipe JSON via stdin
- `bd audit label <id>` - Append quality labels (good/bad) for dataset curation
- `bd compact --audit` - Optionally log compaction prompts/responses
- Audit entries are immutable; labels create new referencing entries
- **Directory-aware label scoping** (GH#541) - Auto-filter issues by directory in monorepos
- Configure `directory.labels` to map paths to label filters
- `bd ready` and `bd list` auto-apply when in matching directories
- Example: `packages/maverick: maverick` shows only maverick-labeled issues
- **Molecules catalog** (gt-0ei3) - Separate storage for template molecules
- Templates now live in `molecules.jsonl`, distinct from work items
- Hierarchical loading: built-in → town → user → project
- Molecules use `mol-*` ID namespace with `is_template: true`
- **Windows winget manifest** (GH#524) - Prepare beads for Windows Package Manager
- Added manifest files for winget submission
- Once merged to microsoft/winget-pkgs: `winget install SteveYegge.beads`
- **Git commit configuration** (GH#600) - Control beads auto-commit behavior
- `git.author` - Override commit author (useful for bots)
- `git.no-gpg-sign` - Disable GPG signing (fixes Touch ID prompts)
- **Require description config** (GH#596) - Enforce descriptions on issue creation
- Set `create.require-description: true` to error on missing descriptions
- Also supports `BD_CREATE_REQUIRE_DESCRIPTION` env var
### Changed
- **`bd stats` merged into `bd status`** (GH#644) - Consolidated status commands
- `stats` now an alias for `status`
- Colorized output with emoji header
- Shows all statistics (tombstones, pinned, epics, lead time)
- Added `--no-activity` flag to skip git activity parsing
- **Thin hook shims** (GH#615) - Hooks now delegate to `bd hooks run`
- Eliminates hook version drift after upgrades
- No more manual `bd hooks install --force` needed
- Shims use `# bd-shim v1` marker (format version, not bd version)
- **MCP context tool consolidation** - Merged 3 tools into 1
- Combined `set_context`, `where_am_i`, `init` into single `context` tool
- Actions: `set` (default with workspace_root), `show` (default), `init`
- **Doctor improvements** (GH#656) - Enhanced diagnostics and testing
- Visual improvements with grouped output
- Comprehensive test coverage added
- Fixed gosec warnings
- Contributed by @rsnodgrass
### Fixed
- **`relates-to` cycle detection** (GH#661) - Exclude relates-to from cycle detection
- Relates-to links are bidirectional by design, not cycles
- **Doctor `.local_version` check** (GH#662) - Check correct version file
- Now checks `.local_version` instead of deprecated `LastBdVersion`
- **Doctor Claude plugin link** (GH#623) - Updated broken documentation link
- **Read-only gitignore in stealth mode** (GH#663) - Print manual instructions instead of failing
- When global gitignore is read-only (e.g., symlink to immutable location), shows what to add manually
- Contributed by @qmx
## [0.30.7] - 2025-12-19
### Fixed