Repository navigation
feat: resumable local Broca setup for independent Scientists - #17
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Independent Scientist users can now preview and initialize empty Broca data without copying maintainer records. Interrupted setup resumes by creating only missing files; conflicting files are preserved and reported. A private local handoff records validation and subsequent publication/connection steps.
Closes #16.
Scripts Changed
broca/setup.py: canonical identity validation, deterministic manifest, atomic create-only initialization/resumption and owner feed validation.broca/__main__.py: setup preview/apply command before configuration loading.tests/test_setup.py: interruption, conflict, preservation, identity and rendering integration coverage.docs/setup.md,README.md: setup and fresh-chat instructions.Validation
python -m pytest -q).Limits
Local setup only; no remote provisioning, publication, activation UI, evaluation or upgrade support. Resume uses the same framework version and paths. Intentional edits to setup files require normal check/render rather than reinitialization. Scientist connection remains gated on a real valid HTTPS feed.
Shipping gate
Heart remains RED; the live human authorized development shipping only:
Tier: judge — human /prm; no merge authority.
Development-only Heart RED override — 2026-10-12
The live user authorized Broca #16 to commit, push and open its PR: "I authroize, go".
This answers the task-specific override request. Merge and release are not authorized.
Current exact Heart RED reasons:
Branch gates: 49 tests passed; existing owner check validates 4 assistants and 18
records; existing board/feed render passed; author diff review and whitespace
check passed. No independent review claimed. This change does not repair Heart.