Skip to content

GrokBestFriend 1.3.1

Latest

Choose a tag to compare

@kuker24 kuker24 released this 17 Aug 05:30
0770fc0

GrokBestFriend 1.3.1

Transactional, fail-closed Design Intelligence bank bootstrap from operator-supplied Open Design ZIPs.

Laptop-new install already packaged the Design Intelligence engine in v1.3.0. This release can also build the searchable catalog — only from four local archives the operator already has the right to use.

Install

# Engine + Refero/Motionsites. Intelligence bank stays missing/DEGRADED.
./install.sh

# Same, plus import four local Open Design ZIPs.
./install.sh --with-design-intelligence-bank ~/OpenDesignPacks

The folder must contain exactly one design-systems*.zip, design-templates*.zip, plugins*.zip, and skills*.zip. Automation can set GROK_DESIGN_INTELLIGENCE_ARCHIVE_DIR. Default ./install.sh does not scan $HOME for those ZIPs.

What this release does

  • Known snapshot od-packs-2026-07-20 only: 906 catalog items (151 / 114 / 479 / 162), 256 aliases, 85 stubs, 7 quarantined
  • Staging at ~/DesignIntelligence.stage.<tx-id> with a private marker, then atomic os.rename
  • Journaled states: PREPARINGBANK_STAGEDGROK_SWAPPEDBANK_PROMOTEDCOMMITTED
  • Crash recovery reloads the journal in a new process (./install.sh --recover)
  • Search gate on the staged catalog before promote
  • Existing healthy matching bank is reused and the install manifest is rewritten
  • Existing corrupt or different bank is EXISTING_BANK_CONFLICT
  • Dry-run creates no directories
  • Bank target is rejected when it is /, $HOME, ~/.grok or a descendant, a Git repository, the archive directory, or an untrusted symlink path
  • ./uninstall.sh keeps ~/DesignIntelligence as user data
  • Doctor: BANK_INTEGRITY can pass while BANK_CONTENT_READINESS stays DEGRADED for unknown licenses, stubs, quarantine, and missing optional connectors. That is expected.

PR: #6

Two banks (unchanged split)

Env Default Contents
GROK_DESIGN_BANK ~/Design Refero + Motionsites for /found-this-design
GROK_DESIGN_INTELLIGENCE_BANK ~/DesignIntelligence Open Design catalog for Impeccable new-work

What is deliberately not here

  • No Open Design ZIP in this Release. Do not expect design-systems.zip or siblings on GitHub.
  • No re-upload of Design-bank.tgz. The Refero/Motionsites archive remains the v1.0.0 asset. SHA-256 is pinned in vendor/sources.json.
  • No --force / --trust / --ignore-hash / --allow-unsafe
  • No second router, no ZIP specialist activation, no change to /found-this-design

Snapshot

product                 = 1.3.1
host                    = Linux x86_64
grok_cli_seen           = 1.0.4
user_skills             = 18
mcp_on                  = codebase-memory-mcp, context7, shadcn@4.18.0
mcp_off                 = serena, exa
plugins                 = none
design_bank_asset       = v1.0.0 Design-bank.tgz
intelligence_bank       = optional, local packs only

Verify

./install.sh --dry-run
./install.sh --doctor

--doctor --strict fails on engine damage and BANK_BLOCKED. Expected bank content DEGRADED does not force a nonzero exit.

Tag target: merge commit on main after the landing-page docs PR.