Skip to content

VibeFrame v0.1.0

Choose a tag to compare

View all tags
@jubayertalha jubayertalha released this 23 Aug 03:40
· 15 commits to main since this release
v0.1.0
da3ecec

The first complete VibeFrame: a control plane for agentic coding — a living, in-repo model of intent, architecture, and code, deterministically indexed, bidirectionally linked, and continuously checked for drift. The framework makes zero LLM calls; your coding agent is the intelligence, connected over MCP.

Highlights

  • The .vibeframe/ model (schemaVersion: 1) — capabilities → workflows → steps with symbol-level code bindings, components with hierarchy and declared dependency allowances, machine-checkable constraints, lockable ADR decisions. Plain YAML/Markdown, versioned by git, with first-class schema versioning and a migration contract.
  • Deterministic code plane — tree-sitter (vendored WASM grammars, no native parser builds) symbol extraction and exact import resolution for TypeScript/JavaScript (tsconfig paths, exports maps) and Python; incremental by content hash; git-aware catch-up; filesystem watcher as the backstop of record.
  • Reflexion drift detection with evidence — absence, divergence, constraint violations, broken bindings (with repair candidates), orphans, cycles, locked-decision touches. Engineered precision-first: every check ships with a false-positive corpus in CI, and a false positive is treated as a product defect.
  • One daemon per project — stateless Streamable-HTTP MCP endpoint (vibe_context, vibe_declare, vibe_link, vibe_decide, vibe_validate, vibe_task, vibe_query), REST + SSE, localhost-only with token auth.
  • Claude Code plugin — session digest injection, same-turn violation feedback after edits, a reconcile nudge at stop, and an opt-in hard gate for files governed by locked decisions; plus /vibeframe:plan-feature, /vibeframe:reconcile, /vibeframe:review-drift.
  • Live browser UI — six lenses (Focus, Map with the declared-vs-actual drift overlay, Flows with verification chips, Decisions, Activity, Drift inbox) and a trust-tier-labeled inspector, updating over SSE with no reloads.
  • Dogfood acceptance suite — the entire loop runs as executable scenarios against the real CLI, daemon, MCP client, and hook scripts: greenfield init through drift, reconciliation, branch switching, restart, and index recovery, including the five-minute understanding test and a ≤4-tool-call overhead budget.

Full details in the CHANGELOG and documentation.

Install

npm i -D vibe-frame-cli   # Node >= 22.12; installs the `vibeframe` command and all internals
npx vibeframe init
npx vibeframe start

Careful: the unhyphenated vibeframe on npm is an unrelated project — don't install that. The attached tarballs offer a registry-free alternative (npm i -D all six files).

Claude Code: /plugin marketplace add jubayertalha/vibeframe → /plugin install vibeframe, or claude mcp add vibeframe -- npx vibeframe mcp for the MCP tools alone. Walkthrough: getting started.

Scope notes

v0.1.0 targets the greenfield loop on TypeScript/JavaScript/Python. Deliberately deferred: brownfield auto-adoption, other-agent adapters, symbol-level call graphs, teams, and anything hosted. Known false negatives of the validator are documented in docs/validation.md.

Assets 8
Loading