Ruflo frictionless setup: bootstrap self-heal + shared worktree memory - #575
Merged
Conversation
…, OKF mirror rule Every new session now gets a working ruflo runtime with zero manual steps: - bin/agent-bootstrap (SessionStart hook) self-heals the two silent failure modes found 2026-08-22: regenerates gitignored .claude/helpers/ via `init upgrade` when the hook handler is missing (otherwise every settings.json hook no-ops behind `|| true`), and symlinks a fresh worktree's .swarm to the main checkout so all sessions share ONE memory DB instead of writing to a store that dies with the worktree. Skipped in CI. Verified end-to-end in this worktree: symlink created, plain `memory list -n okf` reads the shared DB's 30 backfilled entries with no env override. - .okf/workflows/ruflo-runtime.md (new concept) + index row: the runtime map, the okf-namespace mirror + sync rule, distill targets agentdb-memory.db (first run: 660 reasoning patterns, 650 causal edges, 44 promoted), and the v3.6.30 CLI bugs pinned so nobody re-fights them. - CLAUDE.md OKF section: one-line Ruflo-mirror sync rule (concept change => upsert its okf-* memory entry, same commit). - Dated .okf/log.md entry rides this commit (ENFORCED rule). Gates: OKF validator 0 ERRORS (123 warnings, known-red --strict state); bootstrap block exercised live (output in PR); docs+tooling-only diff. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: 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. Comment |
…turdier guards - P1-1: backfilled the 10 concepts the first pass missed (architecture/ x7, content-strategy/ x3 — sections never enumerated); namespace now mirrors all 39 concepts; doc states the coverage, the key-prefix convention (okf-build/-content/-wf/-design/-arch/-cs/-log), and the fresh-MACHINE regeneration path (empty namespace on a new machine by design). - P1-2: bug list re-headed as dated observations on ruflo v3.38.16 — the bootstrap installs @latest, so no pin can hold; doc says re-measure. - P2-3: ln -s → ln -sfn, healing a dangling .swarm symlink (main checkout moved/renamed) instead of WARNing forever. - P2-4: init-upgrade success now measured by the handler file existing, not the npx exit code. - Reviewer's letter-vs-intent verdict adopted: STATUS.md update rule tightened to "ships a PR that changes a workstream's state" (STATUS.md + CLAUDE.md), so the rule can't be mechanically over-applied or quietly ignored. OKF validator: 0 ERRORS. bash -n clean. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
pftg
added a commit
that referenced
this pull request
Aug 22, 2026
Merge rule: docs/instruction/tooling-only PRs do not wait for CI Paul's correction on #575: local gates decide for diffs that cannot change the built site (docs, instruction layer, non-build scripts like bin/agent-bootstrap). CI polling before merge is only for app-build-relevant diffs. One line added to the existing content-only-gates bullet. Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
pftg
added a commit
that referenced
this pull request
Aug 22, 2026
* Merge rule: docs/instruction/tooling-only PRs do not wait for CI Paul's correction on #575: local gates decide for diffs that cannot change the built site (docs, instruction layer, non-build scripts like bin/agent-bootstrap). CI polling before merge is only for app-build-relevant diffs. One line added to the existing content-only-gates bullet. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * AI-ops audit (six-lens swarm): findings doc + OKF log entry Paul asked for a comprehensive AI-operations review with fanned-out subagents. Six read-only lens reviewers (instruction coherence, roster, memory, enforcement, review-loop evidence, cost), each with a mandatory dissent. Converged diagnosis: the failure mode is silent no-op infrastructure, not missing rules. Ranked P0/P1 actions + Paul-decision list in docs/70-79-ai-intelligence/70.12; all four substantive dissents adopted and recorded. Docs-only: local gates (OKF validator 0 errors), merging without CI wait per the 2026-08-22 rule. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
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
2 participants
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
Every new session now gets a working ruflo (claude-flow) runtime with zero manual steps. Closes the two silent failure modes found during the 2026-08-22 enablement work:
.claude/helpers/is gitignored scaffolding, so everysettings.jsonhook called a missing handler behind|| true; intelligence stats sat at zero for months.bin/agent-bootstrap(the SessionStart hook) now runsnpx @claude-flow/cli@latest init upgradewhenever the handler is absent — regenerates helpers, preserves data, touches no tracked files..swarm/is cwd-relative, so worktree sessions wrote to a DB that died with the worktree. Bootstrap now symlinks a fresh worktree's.swarmto the main checkout's: one shared store for CLI and MCP alike. Skipped in CI (no MCP session to feed).Verified live in this worktree: ran the new block via
bash bin/agent-bootstrap→ symlink created, and a plainmemory list -n okf(no env override) reads the shared DB's 30 backfilled OKF entries.Also in this PR
.okf/workflows/ruflo-runtime.md(new concept) + index row + dated log entry (ENFORCED same-commit rule): the runtime map, the okf-namespace ↔ OKF-bundle mirror with its sync rule, whymemory distill runmust targetagentdb-memory.db(first run mined 660 reasoning patterns / 650 causal edges, 44 promoted), and the v3.6.30 CLI bugs pinned so nobody re-fights them (config initoutput breaks its own loader;memory exportandmemory_import_claudebroken; CLI semantic search is MCP-only).okf-*memory entry in the same commit).Gates
--strictstate per log.md).bin/change means CI runs the app build on this PR (not docs-skipped) — will poll checks at the job level before merge.set -usafety, offline npx, main-checkout no-op); merge waits on its verdict.🤖 Generated with Claude Code