mirror of https://github.com/franalgaba/grimoire.git synced 2026-09-14 20:26:31 +08:00

Files

T

Fran Algaba 7df23a47d9 add Yellow + LI.FI multi-track support with ENS hydration and e2e demo runbook (#12 )

* Add impl plan for defihack

* add Yellow + LI.FI multi-track support with ENS hydration and e2e demo runbook

  - implement end-to-end custom action support in compiler, IR generation, runtime action resolution, and executor routing
  - add new offchain venue adapters:  and , and register/export them in
  - add adapter test suites for Yellow session lifecycle and LI.FI swap/bridge/compose_execute flows
  - add LI.FI compose_execute safety guard: enforce  unless explicit override is set
  - add CLI ENS profile hydration (, ) for  and
  - clamp ENS-hydrated  to safe bounds (0..500) in
  - remove unused/dead ENS helper surface
  - add DefiHack demo spells and prompt-first README runbook (VM rehearsal + deterministic CLI e2e)
  - update README and reference docs for new venues and CLI flags

* Add changeset

* Remove unused docs

2026-02-08 15:43:35 +01:00

explanation

auto advisory by model config, OAuth guidance, record/replay flow (#7 )

2026-02-06 21:44:33 +01:00

how-to

implement session-is-the-vm purity boundary, provider/command provenance, and new conformance checks (#11 )

2026-02-08 00:26:03 +01:00

reference

add Yellow + LI.FI multi-track support with ENS hydration and e2e demo runbook (#12 )

2026-02-08 15:43:35 +01:00

tutorials

auto advisory by model config, OAuth guidance, record/replay flow (#7 )

2026-02-06 21:44:33 +01:00

README.md

auto advisory by model config, OAuth guidance, record/replay flow (#7 )

2026-02-06 21:44:33 +01:00

README.md

Grimoire Documentation

This documentation follows the Diátaxis framework. If you're new, start with the execution mode you want to use.

Start here

Grimoire uses the same spell syntax in both environments. The differences are guarantees and tooling.

VM mode (in-agent, best-effort): run spells inside an agent session with snapshot data and no adapters. For quick protocol prototyping, use venue CLI snapshots. Start with Getting started and Run spells in VM mode.
Deterministic runtime (CLI): compile, simulate, and cast with adapters and state persistence. Start with Getting started and Run spells with the CLI.

If you want the full comparison, see Execution modes.

Advisory steps (**...** and advise) call Pi when a model is configured (spell model, CLI model/provider, or Pi defaults). If no model is available, the runtime uses the spell fallback. See CLI reference and Pi advisory execution spec.

Suggested flow: explore in VM → record advisory in CLI simulate → replay deterministically in cast. See Run spells with the CLI.

If you are contributing to the repo, see CONTRIBUTING.md and Run tests and checks.

Updating (user view)

Update the CLI: npm i -g @grimoirelabs/cli@latest
Use npx for latest without install: npx -y @grimoirelabs/cli@latest <command>
Update packages in your project: npm i @grimoirelabs/core@latest @grimoirelabs/venues@latest
Update the VM skill: re-install with npx skills add https://github.com/franalgaba/grimoire (or copy skills/grimoire-vm into your agent skills directory again)

Tutorials

Step-by-step guides for newcomers.

How-to guides

Task-focused recipes.

Reference

Authoritative specifications.

Explanation

Background and design rationale.