Skip to content

NeckBeard v0.2.0

Choose a tag to compare

@openasocket openasocket released this 22 Nov 02:44
· 21 commits to main since this release
v0.2.0
e4fd4c3

What's New in NeckBeard v0.2.0

1. Persistent Load Defaults & Conclusion-Biased Trust Boundaries (.neckbeard.json)

  • Ask once, persist, reuse: When no load is provided in the prompt or repo and the Fast gate applies, NeckBeard asks one brief question to ascertain load, saves it to .neckbeard.json (or via /neckbeard load <value>), and uses it as the project default across sessions and subagents.
  • Per-boundary load envelopes (boundaryLoad): Override load targets per sink or boundary group via /neckbeard load <sink>=<parameters> (e.g., /neckbeard load webhook-in=2000 rps burst).
  • Self-derived trust boundaries & conclusion bias: NeckBeard derives the trust boundary itself from the ask, code, and boundary map, defaulting to a fail-closed conclusion rather than pausing to ask.

2. Concise Internal & External Trust-Boundary Map, Censorship & Git Sharing Toggle

  • Token-efficient two-tier map (<= 680 chars / ~170 tokens): Automatically maps external boundaries (ingress, egress, supply) and internal boundaries (auth, data, exec, ai) via /neckbeard map.
  • Automatic boundary-expansion drift alerts: Detects unreviewed new boundary sinks (⚠ +N boundary) in prompt context, in the Claude Code and Pi banners, and during /neckbeard-review.
  • /neckbeard-debt load-trigger expiry: Automatically compares risk: comment revisit thresholds against .neckbeard.json load and flags exceeded triggers as expired-load-trigger under Must fix now.
  • Shared by default with strict censorship: .neckbeard.json defaults to shared in the repo root (ready to commit to Git) and is strictly censored by hooks/surface.js and hooks/guard.js (repo-relative paths + closed sink enums only; URLs, hostnames, IPs, emails, absolute paths, and secrets are stripped and blocked). Toggle anytime with /neckbeard share on|off.

3. Claude Code AbovePrompt Banner, Local Telemetry Board & VIBES-First Instrumentation

  • Live Claude Code banner (hooks/claude-band.json + hooks/band/): Displays session cost ($), tokens, active agent time, definition reuse %, net refactor line delta (+added/-removed), open callers, PreToolUse guard blocks, security issues found/fixed, boundary drift, and live VIBES PRISM risk score.
  • 100% local HTML dashboard (~/.config/neckbeard/band/board.html) & /neckbeard-gain: Zero network calls. Includes both a Sessions & Telemetry view and an interactive Trust-Boundary Graph SVG architecture diagram.
  • VIBES Protocol (.ai-audit/) priority: Automatically reads .ai-audit/manifest.json and .ai-audit/annotations.jsonl when present for session timelines, line deltas, PRISM risk_score, EVOLVE decisions, and TRACE incident resolution.
  • Native Pi / Oh My Pi (pi-extension/) & OpenCode / Kilo Code (.opencode/) adapters.

4. /neckbeard-audit lite vs. complete Modes

  • lite (default): Targeted end-to-end audit of execution flows and major internal/external data & trust boundaries.
  • complete (/neckbeard-audit complete): Exhaustive audit of every single code, configuration, script, workflow, and documentation file in the repository, with a mandatory upfront time, token, and tool-call warning.