PR 3669 wired Linear-specific logic into every bd command: rootCmd
pre-run ran maybeWarnLinearStaleness (config reads, file stats, stderr
warnings, PPID-keyed temp markers) on all commands, and bd prime
silently shelled out to 'bd linear sync --pull --json' via whatever bd
was on PATH (version skew + network IO at session start). Both hooks
are removed; staleness checking stays opt-in via the existing
'bd linear sync --pull-if-stale' flag, which agents can run from a
session hook if they want fresh data.
The per-machine .beads/last_pull marker is now in the canonical
gitignore template and required patterns, so clones stop committing
and churning it. CONFIG.md updated to match.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
State the rule that makes execution_reasoning_effort and
execution_suggested_model portable across agent runtimes: stored effort
values are a canonical advisory scale that consumers map to their own
runtime, and suggested models are capability-tier hints that consumers
on another provider substitute rather than drop. Also update the
gh-3541 reference: that issue resolved to keep execution hints
metadata-only with no first-class CLI helper.
Agent-Signature: claude-fable-5-high on behalf of matt wilkie
Dolt refuses outright to merge a table whose primary key set differs
across the merging heads or in their common ancestor ("cannot merge
because table X has different primary keys [in its common ancestor]").
The refusal fires before any row conflicts materialize, so the pull
auto-resolver never runs and retrying can never converge the clones —
the residual #4259 hazard for v1.0.4 -> v1.0.6 upgrades with un-synced
dependency edits straddling the 0041/0043/0050 PK reshape.
bd dolt pull/push (and auto-push) now recognize this error class and
print the bootstrap-from-one-canonical-clone recipe (force-push the
canonical clone, export/re-clone/import everywhere else) instead of
just the raw error. Full playbook added as docs/RECOVERY.md#pk-fork-refused,
plus an Unreleased upgrade note: sync every clone before upgrading and
pull immediately after the designated migrator pushes.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* docs: publish community tools on website
Mirror docs/COMMUNITY_TOOLS.md into Docusaurus so the Pages build publishes it for the default released docs and unreleased docs without relying on manual copy steps.
Agent-Signature: codex-gpt-5.5-high on behalf of matt wilkie
* docs: publish core support docs on website
Mirror Sync Concepts, Labels, Metadata, Uninstalling, and Antivirus docs into Docusaurus and include them in the default released snapshot and LLM bundle.
Clarify that agent execution and verification metadata are examples of metadata as a schema extension point, not native issue fields.
Agent-Signature: codex-gpt-5.5-high on behalf of matt wilkie
* docs: clarify metadata examples
Replace local verification queue metadata with a tracker round-trip example so public metadata docs show upstream-aligned schema extension patterns.
Agent-Signature: codex-gpt-5.5-high on behalf of matt wilkie
---------
Allow Jira push to include configured project-specific fields such as Team. Custom field values can be plain strings or JSON objects/arrays for Jira field types that require structured payloads, and per-type config overrides global values after the Beads issue type is mapped to a Jira issue type.
* docs: link canonical SYNC_CONCEPTS.md from deeper docs
SYNC_CONCEPTS.md is the canonical cross-machine sync explainer but was only
linked from README.md. Add a one-line pointer from ARCHITECTURE, DOLT, FAQ,
GIT_INTEGRATION, and SYNC_SETUP so readers deep in those docs can find it.
Docs-only; all pointers steer toward bd dolt push/pull as canonical sync.
Salvages the still-relevant piece of #3726 (closed as superseded by #3909).
Agent-Signature: claude-opus-4-8-medium on behalf of maphew
* docs: dedupe duplicate DOLT.md entry in SYNC_SETUP See Also
The See Also list had two DOLT.md links with different descriptions
(pre-existing on main). Merge into a single entry.
Agent-Signature: claude-opus-4-8-medium on behalf of maphew
* fix(init): honor dolt local-only remote wiring (ga-vjefud.1)
* docs: regenerate CLI reference for dolt.local-only config help
The dolt.local-only config-set example added in cmd/bd/config.go was not
reflected in the generated CLI docs, so the "Check doc flags freshness" CI
job failed on PR #4227. Regenerate from live bd help: docs/CLI_REFERENCE.md,
the website cli-reference page, the 1.0.0/1.0.4 versioned snapshots, and
llms-full.txt. Generated under LC_ALL=C to match CI's glob collation order.
_Claude Opus 4.7 (beads/investigator) on behalf of quad341_
* docs(config): tighten dolt.local-only help wording + cover isDoltLocalOnly()
Maintainer follow-up on #4227. Two non-blocking review nits:
- The config-set example said "Suppress Dolt remote wiring and sync", but
dolt.local-only only gates remote wiring at `bd init` time; it does not
gate runtime `bd dolt push`/`pull`. Reword to "Skip wiring a Dolt sync
remote during bd init" so the help matches the implemented scope.
Mirrored into the five generated CLI-reference artifacts.
- Add TestIsDoltLocalOnly to exercise the new isDoltLocalOnly() config
reader through the env path (BD_DOLT_LOCAL_ONLY). The existing
TestLocalOnlyInitSkipsConfigureButPersistsExplicitRemote passed localOnly
directly and never covered the config-reading helper.
Doc artifacts verified fresh with CGO_ENABLED=0 -tags gms_pure_go (matching
CI): check-doc-flags.sh, check-doc-freshness.sh, and both generate-*.sh
--check all pass.
Agent-Signature: claude-opus-4-8-high on behalf of maphew
---------
Co-authored-by: Jim Wordelman <jim@wordelman.name>
Co-authored-by: matt wilkie <maphew@gmail.com>
* docs: add conservative beads agent profile
_codex-gpt-5.5-medium on behalf of maphew_
* docs: tighten agent-profile wording and cover no-push branches
Address PR #4220 review:
- Drop noisy "Profile model:" prefix from the default-branch profile
rule; lead with the actual instruction.
- Break the single-sentence MCP closeProtocol into two for readability.
- Fix the user-facing repo URL in the generated recipe template
(steveyegge/beads -> gastownhall/beads); Go module imports are
unchanged.
- Add prime_test cases that exercise the no-push branch for both CLI
and MCP outputs, via a new primeNoPushConfigured stub seam.
Naming-vs-mechanism feedback (treat "profile" as wording, not yet
runtime config) is tracked in a separate follow-up issue rather than
expanding this PR's scope.
Agent-Signature: claude-opus-4-7-medium on behalf of maphew
Avoid persisting environment-supplied managed Dolt ports into the repo-local port file, and add a doctor warning plus recovery docs for standalone-to-managed-city handoff conflicts.
_codex-gpt-5.5-high on behalf of matt wilkie_
The repository has moved to gastownhall/beads, but released Go modules still declare github.com/steveyegge/beads. The installer fallback should use the declared module path, and the docs/check should keep future guidance from regressing.
_codex-gpt-5.5-medium on behalf of matt wilkie_
* fix(close): support per-id reasons
Why: upstream GH#3279 reports repeated --reason values applying incorrectly across multi-ID close, while GH#3268 needs a ready zero-dependency regression guard to prevent queue drift.
_codex-gpt-5.5-medium on behalf of matt wilkie_
* docs: refresh close CLI references
_codex-gpt-5.5-medium on behalf of CI Bot_
* fix(close): preserve empty reason compatibility
Ignore empty --reason occurrences so explicit empty strings continue to fall back to the default close reason and do not conflict with --reason-file. Clarify that repeated reasons map to IDs by positional index.
_codex-gpt-5.5-medium on behalf of matt wilkie_
* import: skip stale JSONL issue snapshots
Skip imported JSONL issue records when the local row has a newer updated_at timestamp, and report stale skips without creating no-op commits.
_codex-gpt-5.5-medium on behalf of matt wilkie_
* import: report stale skipped JSONL IDs
Expose stale_skipped_ids in import results so JSON callers can distinguish imported IDs from records that were intentionally skipped as stale.
_codex-gpt-5.5-medium on behalf of maphew_
Main already converted docs/DOLT-BACKEND.md and docs/RELEASING.md into canonical pointer stubs. Finish the consolidation by moving the still-useful verified details into the authoritative docs and fixing stale inbound references that still sent readers to the pointer files.
DOLT.md keeps the server-mode Dolt install notes, remote setup guidance, macOS LaunchAgent setup, direct Dolt CLI usage, accidental data-directory commit cleanup, and the embedded-mode data path correction.
RELEASING.md keeps the release.sh easy path and Docusaurus versioning steps from the retired docs-level guide. AGENT_INSTRUCTIONS.md now links directly to the root releasing guide, and the init error path now links to the canonical Dolt guide under gastownhall/beads.
Refs: GH#3683, PR#3706
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
_codex-gpt-5.5-medium on behalf of matt wilkie_
Refuse setup atomic writes through symlinks unless a caller explicitly opts into following the link, and report partial Claude/Mux setup when agent instructions are skipped.
Document repair steps for repositories already affected by corrupted mode-120000 CLAUDE.md entries.
Refs #3722.
_codex-gpt-5.5-medium on behalf of matt wilkie_
Move Codex native hook metadata under the Codex-only plugin directory so Claude keeps using only its inline `bd prime` hooks.
Leave release version bumps to the maintainer release flow while documenting hook metadata isolation under Unreleased.
Refs #3924.
_codex-gpt-5.5-medium on behalf of matt wilkie_
Record the plugin CLI reference as a pointer-only resource and extend the doc freshness check so it fails if that resource drifts back into a copied command reference.
_codex-gpt-5.5-medium on behalf of CI Bot_
Co-authored-by: CI Bot <ci@beads.test>
Run Codex project setup during `bd init` using the existing setup installer, and stage generated Codex project files in the bootstrap commit.
Also refresh the generated setup/init docs for the new default behavior.
Co-authored-by: Eugene Brevdo <ebrevdo@gmail.com>
_codex-gpt-5.5-medium on behalf of CI Bot_
CI's "Check doc flags freshness" gate was failing because the new
--skip-labels flag added in this PR wasn't reflected in the generated
CLI reference. Regenerated via ./scripts/generate-cli-docs.sh.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The PR added the global --ignore-schema-skew flag but did not
regenerate docs, failing the 'doc flags freshness' check. Output of
./scripts/generate-cli-docs.sh ./bd — adds the flag to the global
flags block in docs/CLI_REFERENCE.md.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Summary:
- Make default `bd show --json` emit relationship/comment counts without materializing dependents and comments.
- Add `--include-dependents` and `--include-comments` for callers that need full streamed payloads.
- Add Count* storage APIs and iterator APIs across Dolt, embedded Dolt, telemetry, and test stubs.
- Keep count and dependent-iterator semantics aligned with existing relationship APIs by including `wisp_dependencies`.
Verification:
- Full PR CI green at 3e036880f.
- go test -tags gms_pure_go ./cmd/bd -run 'TestShallowDependentsForJSON|TestIssueDetailsCountOnlyJSON' -count=1
Refs #4010.
Addresses be-ijck6q.
_codex-gpt-5.5-medium on behalf of matt wilkie_
Co-authored-by: Jim Wordelman <jim@wordelman.name>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(init): make JSONL auto-export opt-in
Default export.auto and export.git-add to false for new repos, make the init prompt opt-in, and update docs/tests to describe JSONL as an optional viewer/interchange/backup export rather than core sync behavior.
Fixes GH#4062
* refactor(auto-export): check commit before throttle
Move cheap Dolt commit change detection ahead of the auto-export throttle and extract the throttle decision into a tested helper. This keeps the default-off design while carrying the compatible part of Jeremy Longshore's GH#4061 refactor.
Based-on: 313e1f8258
Co-authored-by: jeremylongshore <jeremylongshore@users.noreply.github.com>
* docs: regenerate versioned CLI references
* docs: call out JSONL export opt-in change
---------
_codex-gpt-5.5-medium on behalf of CI Bot_
_codex-gpt-5.5-high on behalf of matt wilkie_
Co-authored-by: CI Bot <ci@beads.test>