BlockRunAI/Franklin

📋 Changes

• Before: `/context = 75K/200K (37.8%)`
• After: `/context = 1.9K/200K (1.0%)` — matches Anthropic's true count

✨ Added

• \`franklin doctor\` — one-command health check covering Node version, config directory writability, chain configuration, wallet + balance, gateway reachability, MCP config validity, telemetry state, and PATH sanity on macOS. Prints color-coded verdicts with remedies; \`--json\` for machine-parseable output; exits non-zero on any failing check so CI scripts can gate on it.
• \`PHILOSOPHY.md\` — canonical statement of what Franklin is and isn't. One-line thesis: *Franklin lets you give your AI a budget and walk away.* Names the Economic Agent category, explains why the wallet is the mechanism, and gives the go/no-go test every future feature has to pass.

📋 Changed

• Bash risk classifier extended from ~20 to ~40 dangerous patterns: \`mv -f\` / \`cp -rf\` overwrites, writes redirected into \`/etc\`, \`/usr\`, \`/bin\`, \`/sbin\`, \`/boot\`, \`/lib\`, \`/var/lib\`, \`/sys\`, \`/proc\`; \`tar -C /…\` / \`unzip -d /…\` extraction into system paths; \`eval\` and \`exec bash\`; \`git filter-repo\` / \`filter-branch\` history rewrites; \`DELETE FROM x\` without \`WHERE\`; \`sed -i\` against system paths; \`truncate -s 0\`; \`dd of=\` to raw block devices; \`killall\` / \`poweroff\`; privilege-escalated (\`sudo\` / \`doas\` / \`su -c\`) destructive ops; secret-exfiltration pipes from \`.env\` / \`.ssh\` / \`.gnupg\`.
• Read tool adds NUL-byte content sniff. Files without a known binary extension are now also rejected when the first 8KB contain a NUL byte — catches encrypted \`.env.enc\`, raw \`.data\`, compiled executables with no extension, etc.
• Write tool enforces a 10MB write cap and refuses to write content containing NUL bytes.
• No behavior changes for code paths already within limits. 117 local tests pass.

📦 Install

• \`\`\`bash
• npm install -g @blockrun/franklin@3.8.8
• franklin doctor
• \`\`\`

📋 Full changelog

• [\`main…v3.8.8\`](https://github.com/BlockRunAI/Franklin/compare/v3.8.7...v3.8.8)