Commit graph

502 commits

Author SHA1 Message Date
Steve Yegge
7ebf4df6ac fix(linear): unwire staleness hook from core; gitignore last_pull (bd-6dnrw.12)
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>
2026-06-11 01:14:08 -04:00
matt wilkie
3bf890cb21
docs(metadata): document portability of execution model/effort hints (#4358)
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
2026-06-10 09:30:41 -07:00
Steve Yegge
f97fd4a8b5 fix(dolt): detect Dolt ancestor-PK merge refusals and print bootstrap-canonical-clone recovery (bd-6dnrw.1)
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>
2026-06-09 23:41:19 -04:00
Dustin Brown
9a1c88b63a
/{.github,docs,go,internal,scripts}: bump driver/dolt version to 2.1.4 (#4326)
* /{.github,docs,go,internal,scripts}: bump driver/dolt version to 2.1.4

* /default.nix: update hash
2026-06-08 11:31:14 -07:00
Dustin Brown
d00b890a33
fix(remote): remove cli invocations of 'dolt remote' and exclusively use store method and sql (#4236)
* /{cmd,internal}: remove dolt cli commands

* /cmd/bd/dolt.go: change remote add and remove to do less

* /internal/storage/dolt/credentials_test.go: remove old tests

* /{docs,website}: regen docs

* /internal/storage/dolt: pr feedback

* /website/static/llms-full.txt: regen doc

* docs: refresh versioned CLI docs

* fix: guard CLI routing for SQL remotes (bd-wisp-6ukh)

---------

Co-authored-by: Eddie the Engineer <julianknutsen@users.noreply.github.com>
2026-06-05 13:58:21 -07:00
coffeegoddd☕️✨
14322af05b /{docs,website,scripts}: holy fuck again 2026-06-03 15:16:55 -07:00
coffeegoddd☕️✨
f9a6f503c4 /{docs,website,scripts}: holy fuck again 2026-06-03 15:10:34 -07:00
coffeegoddd☕️✨
a143374ea0 /{docs,website}: again 2026-06-03 14:59:23 -07:00
coffeegoddd☕️✨
04a65cce81 /{cmd,docs,internal,website}: more ci fixes 2026-06-03 14:56:34 -07:00
coffeegoddd☕️✨
f783cbbede /{docs,website}: gen docs 2026-06-03 14:30:53 -07:00
matt wilkie
cea892d43f
docs: publish community tools on website (#4299)
* 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
---------
2026-06-03 13:44:47 -07:00
Medhat Galal
4e8cedc961
Add Jira custom field support for push (#3678)
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.
2026-06-01 07:40:57 -07:00
matt wilkie
8de88e15b7
docs: link canonical SYNC_CONCEPTS.md from deeper docs (#4248)
* 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
2026-05-29 22:44:54 -07:00
Julian Knutsen
9e8d411f71
Add PR CI wrapper command surface (#4211)
* ci: add PR wrapper command surface

* ci: collect wrapper timing in PR checks

* docs: record initial CI wrapper measurements

* ci: add manual measurement workflow

* ci: allow branch measurement dispatch

* ci: keep measuring independent commands after failures

* docs: record branch-dispatched CI measurement

* ci: keep measuring package suites after failures

* docs: record CI measurement batch

* fix: repair CI-measured test failures

* test: make local Go gates hermetic

* ci: add sharded integration measurement lane

* test: fix internal beads integration TestMain

* docs: record fixed integration shard measurement

* ci: add hybrid integration sharding measurement

* ci: speed up cmd/bd test shard discovery

* ci: add 16-way integration sharding measurement

* ci: measure prebuilt cmd bd sharding

* docs: record prebuilt sharding measurement

* docs: design CI build artifact stage

* docs: record repeat prebuilt integration measurement

* ci: add build artifact stage

* ci: reuse build artifact in linux test lane

* ci: promote main linux integration shards

* ci: gate legacy platform tests to main

* ci: satisfy workflow shell lint

* ci: ignore archived migrations in duplicate check

* ci: add package gate wrappers

* test: clean up testing short boundaries

* ci: allow unreleased version docs lag

* ci: gate releases on package checks

* ci: split workflow by tier

* ci: add aggregate PR gates
2026-05-29 18:52:53 -07:00
Jim Wordelman
278b24ab4b
fix(init): honor dolt local-only remote wiring (#4227)
* 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>
2026-05-28 15:41:38 -07:00
matt wilkie
e1e97e6c58
docs: add conservative Beads agent profile (#4220)
* 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
2026-05-28 15:20:25 -07:00
matt wilkie
2141b65823
Merge pull request #4201 from maphew/fix/setup-symlink-followups
fix(setup): harden symlink follow-up handling
2026-05-28 08:08:32 -07:00
matt wilkie
bc56d692b2
Merge pull request #4152 from quad341/feat/be-wwbsv-schema-skew-guard
feat(schema): schema-skew guard — hard fail on forward DB drift (be-wwbsv)
2026-05-28 08:06:46 -07:00
matt wilkie
8aefc326a6
test: improve coverage signal policy (#4219)
_codex-gpt-5.5-medium on behalf of maphew_
2026-05-27 22:05:14 -07:00
matt wilkie
32586cbf61
fix(dolt): detect managed handoff port conflicts (#4217)
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_
2026-05-27 21:48:35 -07:00
matt wilkie
602593b47d
fix(install): use declared module path for go fallback (#4215)
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_
2026-05-27 21:48:24 -07:00
matt wilkie
a180c63066
fix(close): support per-id reasons (#4194)
* 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_
2026-05-27 20:41:07 -07:00
matt wilkie
7229fb1d11
import: skip stale JSONL issue snapshots (#4204)
* 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_
2026-05-27 20:40:12 -07:00
Julian Knutsen
6fc67e6908 docs: record CI cleanup plan 2026-05-28 01:19:14 +00:00
CI Bot
20bb11d4f3 docs: finish Dolt and release doc consolidation
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_
2026-05-27 18:10:47 -07:00
coffeegoddd☕️✨
316cfc697b /{cmd,docs,internal,website}: remove pass 2026-05-27 16:32:28 -07:00
coffeegoddd☕️✨
a106722705 /{cmd,docs,internal,website}: wire up 2026-05-27 15:30:47 -07:00
coffeegoddd☕️✨
e4b4d846c4 /{docs,website}: gen docs for new flags 2026-05-27 14:43:15 -07:00
coffeegoddd☕️✨
885eacb3df /{docs,website}: gen docs 2026-05-27 13:40:11 -07:00
matt wilkie
86545f64f3 fix(setup): harden symlink follow-up handling
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_
2026-05-27 13:32:00 -07:00
Chris DiMartino
0afd3d5b94
fix(codex): ship hook release safely
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_
2026-05-27 13:19:41 -07:00
matt wilkie
5feba36752
docs: design required CI gate topology (#4179)
_codex-gpt-5.5-high on behalf of CI Bot_
2026-05-26 15:58:04 -07:00
matt wilkie
ade96333fd
docs: guard plugin CLI reference pointer (#4177)
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>
2026-05-26 15:31:24 -07:00
matt wilkie
5de494b85e
Merge pull request #3562 from quad341/release/be-l9q
feat(list): add --skip-labels hydration toggle
2026-05-26 15:13:54 -07:00
Julian Knutsen
aa9ee7f632 docs: audit CI test surface (bd-jot) 2026-05-26 20:18:40 +00:00
Eugene Brevdo
5d33b4c891
init: run Codex project setup by default
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_
2026-05-26 13:03:37 -07:00
coffeegoddd☕️✨
e898babbe6 /{cmd,docs,website}: gen docs again 2026-05-26 10:13:11 -07:00
coffeegoddd☕️✨
3080839f11 /{cmd,docs,website}: gen docs 2026-05-26 10:03:22 -07:00
Jim Wordelman
70c82c0363 docs(list): regenerate CLI reference for --skip-labels (be-rqm7yb)
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>
2026-05-25 16:26:19 -07:00
Jim Wordelman
fcbb82318d docs(cli): regenerate CLI reference for --ignore-schema-skew
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>
2026-05-25 13:42:31 -07:00
Julian Knutsen
f8b9400165
fix(create): commit labels during initial issue creation (#4149)
* fix(dolt): commit initial create relations

* fix(cli): create labels in initial issue write

* fix: address create review findings

* fix: preserve tolerant import dependency handling

* fix: skip mixed-bucket import dependencies (bd-6r6rc)
2026-05-24 19:23:46 -07:00
Jim Wordelman
cfcc957995
feat(show): count-only JSON details with opt-in streamed payloads
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>
2026-05-22 16:54:15 -07:00
Medhat Galal
99565c0d25 Merge remote-tracking branch 'upstream/main' into AI/import-path-config-upstream
# Conflicts:
#	cmd/bd/config.go
#	cmd/bd/init_templates.go
#	docs/CLI_REFERENCE.md
#	docs/CONFIG.md
#	website/docs/cli-reference/config.md
#	website/versioned_docs/version-1.0.0/cli-reference/config.md
#	website/versioned_docs/version-1.0.4/cli-reference/config.md
2026-05-22 00:40:02 -04:00
matt wilkie
3988db7e0d
fix(init): make JSONL auto-export opt-in (#4063)
* 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>
2026-05-21 16:21:00 -07:00
Medhat Galal
eea1cce5ab Merge remote-tracking branch 'upstream/main' into AI/import-path-config-upstream
# Conflicts:
#	docs/CONFIG.md
2026-05-21 02:05:29 -04:00
matt wilkie
39f3148fc2
docs: clarify export versus database backup (#4048)
* docs: clarify export versus database backup
* docs: remove remaining JSONL backup wording
2026-05-20 16:19:23 -07:00
Medhat Galal
b1c968e91f Document import path portability 2026-05-19 16:34:17 -04:00
coffeegoddd☕️✨
4b5936df91 /{docs,website}: generate docs 2026-05-19 12:59:04 -07:00
Medhat Galal
507b2a1fb5 Add configurable JSONL import path 2026-05-19 13:37:32 -04:00
Dustin Brown
1866f161db
Merge pull request #3946 from coffeegoddd/db/1.88.1
/{docs,.github,internal,scripts}: dolt 1.88.1
2026-05-15 09:04:23 -07:00