Skip to content

Stand up the Intent Solutions fork infrastructure for the Buzz adoption (Phase 1 / E1) - #2

Merged
jeremylongshore merged 2 commits into
mainfrom
feat/is-fork-infrastructure
Jul 29, 2026
Merged

Stand up the Intent Solutions fork infrastructure for the Buzz adoption (Phase 1 / E1)#2
jeremylongshore merged 2 commits into
mainfrom
feat/is-fork-infrastructure

Conversation

@jeremylongshore

@jeremylongshore jeremylongshore commented Jul 29, 2026

Copy link
Copy Markdown

What

Stands up the Intent Solutions fork infrastructure for the Buzz adoption (Phase 1 / E1 of the master blueprint, bead buzz-4ei): 000-docs/ planning artifacts (master blueprint 001, adoption decision record 002, public-safe deploy posture 003, 000-INDEX.md), FORK.md (the fork contract + must-survive set), TEST_AUDIT.md (testing-SOP baseline, diagnostic only), and the tracked beads set (.beads/ — prefix buzz, portable issues.jsonl mirror).

Why + decision rationale

Owner decision 2026-07-28: adopt Block's Buzz as the internal team-chat surface, self-hosted as a closed relay. The fork is the adoption home; tracking must exist before any hosting/onboarding work so every subsequent step lands as a tracked bead (owner-specified ordering). Chose a divergent-but-rebase-clean fork carrying additive-only files (the now-lms model) over (a) a bare upstream clone with external docs — because the blueprint must travel with the repo it governs — and (b) modifying upstream files — because rebase cleanliness against a fast-moving upstream is the cheaper long-term posture.

Layers touched

Fork governance layer only. Zero upstream-path edits — verify with git diff upstream/main --stat on this branch: every path is fork-added (000-docs/, FORK.md, TEST_AUDIT.md, .beads/).

How it works

  • 000-docs/001 is the standing execution authority: dependency-ordered phase→epic tree (hosting → hardening gates → onboarding → agents → plugin → contribution lane) with a completion ledger; execution prompts are extracted from it, never re-derived per session.
  • Public/private split is architectural: this fork is public (GitHub forks of public repos cannot be made private), so it carries code + public-safe planning only; every operator-private detail lives in the private operations repo, which the blueprint points to.
  • Beads: own DB (prefix buzz), Dolt-backed, hooks installed per-clone; three-way mirror bead ↔ GitHub issue ↔ Plane.

Verification & evidence

Risk assessment

Low: documentation + tracking only; no code, no CI, no deploy surface. Residual risk: upstream may later add colliding paths (e.g. their own 000-docs/) — the rebase checklist in FORK.md catches that.

Operational impact

None yet — hosting (Phase 2) is deliberately not part of this PR and is gated on the blueprint's blocking go-live gates.

Follow-up & deferred (beads)

  • buzz-4ei.3 — implement the fork-lane test layers (additive-only invariant gate, in-repo audit-harness, Layer-1 hooks) per TEST_AUDIT.md's handoff block.
  • Phase 2 hosting epic — authored from the blueprint when work opens (one epic at a time).

Refs

Refs #1 (E1 cluster issue — stays open; buzz-4ei.3 remains).

Summary by CodeRabbit

  • New Features

    • Added an integrated, Git-based issue-tracking workflow with command-line quick-start guidance.
    • Added automated repository hooks for issue updates during commits, merges, checkouts, and pushes.
  • Documentation

    • Added adoption planning, deployment posture, decision records, fork guidelines, and testing audit documentation.
    • Added a documentation index for the new planning and operational materials.
  • Chores

    • Added repository configuration and local-state protections for reliable issue tracking and synchronization.
    • Added initial project issue and interaction records.

…option

What: 000-docs planning set (001 master blueprint = standing execution
authority with completion ledger; 002 adoption decision record; 003
public-safe deploy posture; 000-INDEX), FORK.md (fork contract +
must-survive set), TEST_AUDIT.md (testing-SOP diagnostic baseline), and
the tracked beads set (prefix buzz, epic buzz-4ei + 4 children).

Why: owner decision 2026-07-28 to adopt Buzz as the internal team-chat
surface; tracking must exist before any hosting/onboarding work. Chose a
rebase-clean additive-only fork (the now-lms model) over modifying
upstream files so rebases against a fast-moving upstream stay
conflict-free; deploys ride upstream images, so no deploy branch exists
until we carry a patch.

Verified: git diff upstream/main --stat shows only fork-added paths;
beads round-trip proven (create/update/close/export) after fixing bd's
git-fork contributor-role routing via bd init --role maintainer.
@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@jeremylongshore, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 52 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 21d7d0b3-fa33-4199-8f5d-5f6942dd38ec

📥 Commits

Reviewing files that changed from the base of the PR and between 7ca59bb and e49ed40.

📒 Files selected for processing (3)
  • 000-docs/001-PP-PLAN-buzz-adoption-master-blueprint.md
  • 000-docs/003-OD-DEPL-deploy-posture-public.md
  • TEST_AUDIT.md
📝 Walkthrough

Walkthrough

Adds Beads/Dolt tracking files and Git hooks, establishes fork governance, and documents Buzz adoption architecture, deployment posture, decision records, and testing-audit requirements.

Changes

Buzz fork foundation

Layer / File(s) Summary
Beads and Dolt activation
.beads/*
Adds Beads metadata, issue and interaction records, configuration, documentation, ignore rules, and Git hook wrappers with timeout and exit-code handling.
Fork contract and testing audit
FORK.md, TEST_AUDIT.md
Defines additive-only fork rules, must-survive checks, upstream test classifications, current contract findings, and planned fork-gate work.
Adoption execution blueprint
000-docs/001-PP-PLAN-buzz-adoption-master-blueprint.md
Documents Buzz architecture, phased adoption execution, Beads tracking, relay hardening, onboarding, agent integration, contribution governance, and standing constraints.
Adoption decision and deployment posture
000-docs/000-INDEX.md, 000-docs/002-DR-DECR-buzz-adoption-decision-record.md, 000-docs/003-OD-DEPL-deploy-posture-public.md
Adds the document index, ratified adoption decision, target deployment topology, update and rollback behavior, controls, and go-live gates.

Estimated code review effort: 3 (Moderate) | ~30 minutes

Possibly related issues

  • intent-solutions-io/buzz#1 — Covers the fork infrastructure, documentation, and Beads/Dolt activation implemented by this change.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: establishing the Intent Solutions fork infrastructure for Buzz adoption in Phase 1/E1.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/is-fork-infrastructure

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 6

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.beads/config.yaml:
- Around line 58-66: Update the Integration settings documentation in
config.yaml to remove API keys and tokens as supported or acceptable file-stored
values. Require LINEAR_API_KEY and GITHUB_TOKEN environment variables, and add
guidance for secret scanning and rotating exposed credentials; if unavoidable
token persistence is documented, explicitly require storage outside tracked
Git/Dolt history.
- Line 68: Remove the public GitHub URL from the sync.remote setting in
.beads/config.yaml and configure it to use a private Dolt remote instead. Ensure
the existing Beads/Dolt issue data and history are not pushed to the public
repository; if no private remote is available, disable syncing until the data is
scrubbed.

In `@000-docs/001-PP-PLAN-buzz-adoption-master-blueprint.md`:
- Around line 28-30: The closed-relay configuration documentation omits the
required stable relay private-key variable. In
000-docs/001-PP-PLAN-buzz-adoption-master-blueprint.md lines 28-30, add
BUZZ_RELAY_PRIVATE_KEY to the public-safe prerequisite list without exposing its
value; in lines 113-115, replace “closed-relay trio” with wording that names the
complete four-variable configuration set, also without disclosing key material.
- Around line 116-120: Update the E2b wrapped auto-update lane rollback
procedure to restore the named Postgres, media, and git recovery point before
starting the prior digest whenever migration or functional-probe writes
occurred. Retain the existing auto-revert and alert behavior, but explicitly
sequence recovery-point restoration before launching the previous release.

In `@000-docs/003-OD-DEPL-deploy-posture-public.md`:
- Around line 24-34: Update the deployment rollback procedure described in the
“Auto-migrate” and “On any probe failure” steps to require stopping and draining
writes or enforcing read-only mode before migration/probing, restoring every
store from a verified restorable snapshot, repinning the last-known-good digest,
restarting, and rerunning the functional probe in that order. Clarify that
snapshot markers represent actual restorable backups, and revise the RPO claim
wherever it cannot guarantee this write-safe rollback sequence.

In `@TEST_AUDIT.md`:
- Line 110: Update handoff item 8 in TEST_AUDIT.md to remove the
already-satisfied requirement to add this file to FORK.md, leaving only the
requirement to include scripts/fork-gates/; alternatively, mark the audit-file
entry as complete.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8558bc61-1a09-4486-98a8-929fd88ee2b6

📥 Commits

Reviewing files that changed from the base of the PR and between 6300a6b and 7ca59bb.

📒 Files selected for processing (17)
  • .beads/.gitignore
  • .beads/README.md
  • .beads/config.yaml
  • .beads/hooks/post-checkout
  • .beads/hooks/post-merge
  • .beads/hooks/pre-commit
  • .beads/hooks/pre-push
  • .beads/hooks/prepare-commit-msg
  • .beads/interactions.jsonl
  • .beads/issues.jsonl
  • .beads/metadata.json
  • 000-docs/000-INDEX.md
  • 000-docs/001-PP-PLAN-buzz-adoption-master-blueprint.md
  • 000-docs/002-DR-DECR-buzz-adoption-decision-record.md
  • 000-docs/003-OD-DEPL-deploy-posture-public.md
  • FORK.md
  • TEST_AUDIT.md

Comment thread .beads/config.yaml
Comment on lines +58 to +66
# Integration settings (access with 'bd config get/set')
# Non-secret keys (stored in the database):
# - jira.url, jira.project
# - linear.team_id
# - github.org, github.repo
#
# Secret keys (stored in this file but prefer env vars to avoid git exposure):
# - linear.api_key → use LINEAR_API_KEY env var instead
# - github.token → use GITHUB_TOKEN env var instead

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "==tracked config files around .beads/config.yaml=="
git ls-files | rg '(^|/)\.beads/config\.yaml|config\.ya?ml|.*beads.*' || true

echo
echo "==lines 50-75 of .beads/config.yaml if present=="
if [ -f .beads/config.yaml ]; then
  nl -ba .beads/config.yaml | sed -n '50,75p'
fi

echo
echo "==search for token/api_key and database secret docs==
rg -n -i "api_key|secret|secret keys|plaintext|tracker-token|token|linear|github" .beads README.md .github 2>/dev/null || true

Repository: intent-solutions-io/buzz

Length of output: 588


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "==tracked config files around .beads/config.yaml==
git ls-files | grep -E '(^|/)\.beads/config\.yaml|config\.ya?ml|.*beads.*' || true

echo
echo "==lines 50-75 of .beads/config.yaml if present==
if [ -f .beads/config.yaml ]; then
  awk 'NR>=50 && NR<=75 {printf "%5d  %s\n", NR, $0}' .beads/config.yaml
fi

echo
echo "==search for token/api_key/db plaintext docs==
grep -RIniE "api_key|secret keys|secretkeys|secret|plaintext|tracker-token|tracker.*token|linear.api_key|github.token|security|rotation|scan|LINEA?R_API_KEY|GITHUB_TOKEN" . --exclude-dir=.git 2>/dev/null || true

Repository: intent-solutions-io/buzz

Length of output: 1103


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "==tracked files around .beads/config.yaml=="
git ls-files | grep -E '(^|/)\.beads/config\.yaml|(^|/)config\.ya?ml$|(^|/)Readme.*|(^|/)readme.*|\.beads/README\.md|\.beads/.*' || true

echo
echo "==lines 50-75 of .beads/config.yaml==
awk 'NR>=50 && NR<=75 {printf "%5d  %s\n", NR, $0}' .beads/config.yaml

echo
echo "==tracked gitignore for .beads/config.yaml and secret patterns==
awk 'NR>=1 && NR<=200 {printf "%5d  %s\n", NR, $0}' .beads/.gitignore

echo
echo "==search for Beads token/config/documentation==
grep -RIniE "\\b(beads|bd config|api_key|secret keys|secretkeys|secret|plaintext|tracker-token|tracker.*token|linear.api_key|github.token|LINEA?R_API_KEY|GITHUB_TOKEN|security|rotation|scan)\\b" . --exclude-dir=.git --exclude-dir=node_modules --exclude='*.lock' 2>/dev/null || true

Repository: intent-solutions-io/buzz

Length of output: 3024


🌐 Web query:

Beads steveyegge .beads/config.yaml linear.api_key github.token security security.md tracker-token

💡 Result:

Beads is an open-source, persistent memory and issue-tracking system for AI coding agents, created by Steve Yegge [1][2]. It allows agents to handle long-horizon tasks by providing a dependency-aware graph that replaces standard markdown plans [1][3]. The system is managed via the bd CLI tool and utilizes a Dolt database for version-controlled storage [3]. Regarding your configuration query, Beads manages settings in two ways [4]: 1. Tool-level configuration is stored in config.yaml files [4]. 2. Project-level configuration (including integration credentials) is primarily stored in the project's Dolt database [4]. Specific security considerations for keys like linear.api_key, github.token, and tracker-related tokens include: Security Best Practices: Beads explicitly prevents writing sensitive keys (containing names like api_key, secret, token, or password) to git-tracked config.yaml files by default [4][5][6]. This is a security measure to prevent leaking credentials into git history [5]. If you attempt to use bd config set for these keys, the system will refuse the write unless you explicitly use the --force-git-tracked flag [4][6]. Recommended Configuration: The authoritative recommendation for sensitive keys is to export them as environment variables [4][7][5]. This ensures they are not stored in your project's configuration files [4][6]. Examples: - export LINEAR_API_KEY="your_api_key" [7][6] - export GITHUB_TOKEN="your_token" [6] When these environment variables are present, Beads can consume them automatically for authentication [4][6]. Non-sensitive configuration (e.g., linear.team_id) can safely be set using bd config set [7][6]. The config.yaml file should be reserved for tool-level startup settings and non-sensitive behavior configurations [4][6].

Citations:


Stop documenting config.yaml as a secret store.

This tracked file lists linear.api_key and github.token as acceptable values, while .gitignore explicitly says config files are tracked and .beads/config.yaml only says to prefer env vars. Require env variables for API keys and add secret-scanning/rotation guidance; if token storage is unavoidable, ensure it is not stored in tracked Git/Dolt history.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.beads/config.yaml around lines 58 - 66, Update the Integration settings
documentation in config.yaml to remove API keys and tokens as supported or
acceptable file-stored values. Require LINEAR_API_KEY and GITHUB_TOKEN
environment variables, and add guidance for secret scanning and rotating exposed
credentials; if unavoidable token persistence is documented, explicitly require
storage outside tracked Git/Dolt history.

Source: MCP tools

Comment thread .beads/config.yaml
# - linear.api_key → use LINEAR_API_KEY env var instead
# - github.token → use GITHUB_TOKEN env var instead

sync.remote: "https://github.com/intent-solutions-io/buzz.git" No newline at end of file

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔒 Security & Privacy | 🟠 Major | 🏗️ Heavy lift

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== repo files of interest =="
git ls-files | rg '(^|/)(FORK\.md|\.beads/config\.yaml|\.beads/issues\.jsonl|docs/DOLT\.md|\.beads)' || true

echo
echo "== .beads/config.yaml =="
if [ -f .beads/config.yaml ]; then
  nl -ba .beads/config.yaml | sed -n '1,120p'
fi

echo
echo "== FORK.md =="
if [ -f FORK.md ]; then
  nl -ba FORK.md | sed -n '1,160p'
fi

echo
echo "== docs/DOLT.md (lines mentioning GitHub/push/remote) =="
if [ -f docs/DOLT.md ]; then
  rg -n -C 3 -i 'github|push|remote|clone|dolt|beads|sync' docs/DOLT.md || true
fi

echo
echo "== .beads/issues.jsonl sample and sensitive fields =="
if [ -f .beads/issues.jsonl ]; then
  wc -l .beads/issues.jsonl
  nl -ba .beads/issues.jsonl | sed -n '1,80p'
  echo "-- matches for sensitive-looking strings --"
  rg -n 'plane|operations|owner|@|github|buzz|https?://' .beads/issues.jsonl || true
fi

Repository: intent-solutions-io/buzz

Length of output: 516


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== repo files of interest =="
git ls-files | rg '(^|/)(FORK\.md|\.beads/config\.yaml|\.beads/issues\.jsonl|docs/DOLT\.md|\.beads)' || true

echo
echo "== .beads/config.yaml =="
if [ -f .beads/config.yaml ]; then
  nl -ba .beads/config.yaml | sed -n '1,120p'
fi

echo
echo "== FORK.md =="
if [ -f FORK.md ]; then
  nl -ba FORK.md | sed -n '1,160p'
fi

echo
echo "== docs/DOLT.md (lines mentioning GitHub/push/remote) =="
if [ -f docs/DOLT.md ]; then
  rg -n -C 3 -i 'github|push|remote|clone|dolt|beads|sync' docs/DOLT.md || true
fi

echo
echo "== .beads/issues.jsonl sample and sensitive fields =="
if [ -f .beads/issues.jsonl ]; then
  wc -l .beads/issues.jsonl
  nl -ba .beads/issues.jsonl | sed -n '1,80p'
  echo "-- matches for sensitive-looking strings --"97 || true
fi

Repository: intent-solutions-io/buzz

Length of output: 516


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== .beads/config.yaml =="
python3 - <<'PY'
from pathlib import Path
for i, line in enumerate(Path('.beads/config.yaml').read_text().splitlines(), 1):
    if i <= 120:
        print(f"{i:4d}\t{line}")
PY

echo
echo "== FORK.md =="
python3 - <<'PY'
from pathlib import Path
for i, line in enumerate(Path('FORK.md').read_text().splitlines(), 1):
    if i <= 180:
        print(f"{i:4d}\t{line}")
PY

echo
echo "== docs/DOLT.md remote/push mentions =="
python3 - <<'PY'
from pathlib import Path
p = Path('docs/DOLT.md')
if p.exists():
    lines = p.read_text().splitlines()
    hits = []
    for i, line in enumerate(lines, 1):
        if any(s in line.lower() for s in ['github', 'push', 'remote', 'clone', 'dolt', 'beads', 'sync']):
            start=max(1,i-3); stop=min(len(lines),i+3)
            hits.append((i,start,stop))
    printed=set()
    for i,start,stop in hits:
        for n in range(start,stop+1):
            if n not in printed:
                print(f"{n:4d}\t{lines[n-1]}")
                printed.add(n)
else:
    print("docs/DOLT.md not found")
PY

echo
echo "== .beads/issues.jsonl sample and sensitive text =="
python3 - <<'PY'
from pathlib import Path
p=Path('.beads/issues.jsonl')
lines=p.read_text().splitlines() if p.exists() else []
print(f"line_count={len(lines)}")
for i, line in enumerate(lines[:80], 1):
    print(f"{i:4d}\t{line}")
print("\n-- sensitive matches --")
import re
keys={'plane','operations','owner','github.com/intent','buzz.git','https://'}
for i, line in enumerate(lines, 1):
    if any(k in line.lower() for k in keys) or re.search(r'[\w.-]+@\w[\w.-]*|https?://', line):
        print(f"{i:4d}\t{line}")
PY

echo
echo "== other relevant .beads metadata =="
python3 - << 'PY'
from pathlib import Path
for name in [".beads/metadata.json", ".beads/README.md", ".beads/interactions.jsonl"]:
    p=Path(name)
    print(f"\n--- {name} ---")
    if p.exists():
        txt=p.read_text()
        for i,line in enumerate(txt.splitlines()[:120],1):
            print(f"{i:4d}\t{line}")
    else:
        print("not found")
PY

echo
echo "== hook evidence for Dolt/Git push =="
for f in .beads/hooks/pre-push .beads/hooks/post-merge; do
  if [ -f "$f" ]; then
    echo "--- $f ---"
    cat "$f"
  fi
done

Repository: intent-solutions-io/buzz

Length of output: 23901


🌐 Web query:

Beads steveyegge sync.remote Dolt remote github.com/intent-solutions-io/buzz.git

💡 Result:

The query combines several distinct technical concepts and repositories related to Steve Yegge's "Beads" project and the organization intent-solutions-io. Beads Beads is a persistent, structured memory system for AI coding agents, created by Steve Yegge [1][2]. It operates as a git-backed, dependency-aware graph issue tracker that uses the Dolt database engine to store agent memory and task history [3][4][5]. The Beads CLI tool (bd) allows agents to maintain long-horizon context that survives session rotations [4]. sync.remote and Dolt In the context of Beads, sync.remote is a configuration key used to manage cross-machine synchronization of the Dolt-backed issue database [6][7]. - It acts as the primary configuration for the remote URL used during bootstrap or synchronization operations [6][8]. - It supports various Dolt-compatible remote schemes, including git-based remotes (e.g., git+ssh://, git+https://), S3, GCS, and local paths [6][7]. - The setting is typically persisted in.beads/config.yaml [6][7]. - Beads leverages Dolt's ability to store issue data in refs/dolt/data, distinct from standard git source branches, enabling seamless synchronization alongside traditional git workflows [7][5]. github.com/intent-solutions-io/buzz.git There is no publicly available repository at github.com/intent-solutions-io/buzz.git as of July 2026. The search results identify several unrelated projects named "buzz" (e.g., by chidiwilliams, ademilter, and vibbits) [9][10][11] and list other repositories associated with intent-solutions-io (such as perception-with-intent), but none matching the specified path [12]. It is possible this path refers to a private repository or a typo in the request.

Citations:


Do not sync Beads/Dolt issue data to the public GitHub remote.

.beads/config.yaml points sync.remote at https://github.com/intent-solutions-io/buzz.git, and this fork is declared public in FORK.md. .beads/issues.jsonl contains owner/actor identity plus Plane and private operations path references, while .beads/metadata.json shows the Dolt store is enabled and .beads/README.md advertises bd dolt push / sync. Use a private Dolt remote, or scrub existing issue data/history before pushing.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.beads/config.yaml at line 68, Remove the public GitHub URL from the
sync.remote setting in .beads/config.yaml and configure it to use a private Dolt
remote instead. Ensure the existing Beads/Dolt issue data and history are not
pushed to the public repository; if no private remote is available, disable
syncing until the data is scrubbed.

Source: MCP tools

Comment thread 000-docs/001-PP-PLAN-buzz-adoption-master-blueprint.md Outdated
Comment thread 000-docs/001-PP-PLAN-buzz-adoption-master-blueprint.md Outdated
Comment thread 000-docs/003-OD-DEPL-deploy-posture-public.md Outdated
Comment thread TEST_AUDIT.md Outdated
What: name the full closed-relay configuration set (adds the required
stable BUZZ_RELAY_PRIVATE_KEY relay identity, sops-held, key material
never documented); make the wrapped-updater rollback write-safe and
strictly ordered (write-isolate -> bound restorable recovery point ->
promote -> migrate -> probe -> on failure restore ALL stores BEFORE
repinning and starting the prior image, since migrations are
forward-only); correct the RPO claim (zero for the write-isolated update
window; <=24h only for host loss); drop an already-satisfied item from
the TEST_AUDIT handoff.

Why: CodeRabbit review on #2 — following the doc
as written could start a relay without its identity key, and an
unordered auto-revert could boot the prior image against migrated state.

Verified: doc-only; git diff upstream/main --stat still shows only
fork-added paths.
@jeremylongshore

Copy link
Copy Markdown
Author

Review findings addressed in e49ed40:

  • BUZZ_RELAY_PRIVATE_KEY added to the closed-relay configuration set in the blueprint (§ground truth + §E2) and the deploy-posture doc's private-lane mirror — fixed.
  • Rollback ordering now explicit and write-safe in both docs: write-isolate → bound restorable recovery point (all three stores, one named point — markers language removed) → promote → migrate → probe → on failure restore every store BEFORE repinning/starting the prior image (migrations are forward-only). RPO restated: zero for the write-isolated update window; ≤24 h only for host loss — fixed.
  • TEST_AUDIT handoff item 8 de-duplicated — fixed.

Declined, with reasons:

  • .beads/config.yaml "documents a secret store": that file is bd's generated template — the flagged lines are upstream beads' own commented documentation, not our policy; no secret values are present, and bd itself refuses bd config set writes of key-like names to git-tracked config without --force-git-tracked. Estate policy (sops + env) governs; we don't edit generated template comments.

  • "Do not sync beads to the public remote": deliberate, standing Intent Solutions practice — the tracked issues.jsonl is the portable public-safe mirror (plain-English titles, no secrets, no PII; the "private operations" strings are pointers, not content), same model as our other public repos. Bead content is authored under a public-safe rule; anything operator-private lives in the private ops repo only.

  • Jeremy Longshore
    intentsolutions.io

@jeremylongshore
jeremylongshore merged commit 6cf4df9 into main Jul 29, 2026
1 check was pending
@jeremylongshore
jeremylongshore deleted the feat/is-fork-infrastructure branch July 29, 2026 04:35
jeremylongshore added a commit that referenced this pull request Jul 29, 2026
What: issues.jsonl/interactions.jsonl reflect buzz-4ei.4 closed (mirror +
memory seeding done) and the E1 milestone notes added post-merge.

Why: the tracked JSONL is the portable mirror of the Dolt store; closes
executed after PR #2 merged, so the mirror flush rides its own branch
(main is never committed to directly).

Verified: bd show buzz-4ei.4 = CLOSED; export succeeded.

Co-authored-by: jeremylongshore <jeremylongshore@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant